home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / bbs / bw401pcb.zip / BWMAIL.DOC < prev    next >
Text File  |  1996-09-02  |  128KB  |  2,624 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.        The Blue Wave Offline Mail Door for PCBoard, Version 4.00
  12.        Copyright (C) 1992-1996 by Cutting Edge Computing
  13.        All Rights Reserved
  14.  
  15.        Configuration and Reference Manual
  16.        Written by George Hatchew and Martin Pollard
  17.  
  18.        Cutting Edge Computing
  19.        P.O. Box 90476
  20.        Burton, Michigan  49509-0476
  21.        USA
  22.  
  23.        BBS Support Number:  +1-810-743-8464
  24.        FAX Support Number:  +1-810-743-5910 (REGISTERED users only)
  25.  
  26.        Internet E-Mail   :  bluewave@concentric.net
  27.        World Wide Web    :  http://www.concentric.net/~bluewave
  28.  
  29.  
  30.  
  31.                                  TABLE OF CONTENTS
  32.                                  -----------------
  33.        Chapter 1
  34.            ABOUT THIS DOCUMENTATION                               3
  35.        Section 1.1  Purpose of this Documentation                 3
  36.        Section 1.2  Printing this Documentation                   4
  37.        Chapter 2
  38.            LICENSING AND DISTRIBUTION                             5
  39.        Section 2.1  Software License Agreement                    5
  40.        Section 2.2  Purchasing a License                          6
  41.        Section 2.3  Corporate and Governmental Purchase Orders    8
  42.        Section 2.4  What You Receive When You Order               8
  43.        Section 2.5  Registered User License                       9
  44.        Section 2.6  Trademarks and Credits                        9
  45.        Chapter 3
  46.            ABOUT THE BLUE WAVE MAIL DOOR                         11
  47.        Section 3.1  History of Offline Mail Systems              11
  48.        Section 3.2  What Are E-Mail Networks For?                12
  49.        Section 3.3  What Features are in Blue Wave?              12
  50.        Chapter 4
  51.            HARDWARE AND SOFTWARE REQUIREMENTS                    14
  52.        Section 4.1  Different Blue Wave Mail Door Versions       14
  53.        Section 4.1.1  Requirements for The Blue Wave Mail Door   14
  54.        Section 4.2  Different Blue Wave Reader Versions          15
  55.        Section 4.2.1  Requirements for Blue Wave/DOS             15
  56.        Section 4.2.2  Requirements for Blue Wave/386             16
  57.        Section 4.2.3  Requirements for Blue Wave/OS2             17
  58.        Section 4.3  Locating Other Blue Wave Versions            17
  59.        Section 4.4  Required External Programs                   18
  60.        Section 4.5  MS-DOS CONFIG.SYS Settings                   18
  61.        Chapter 5
  62.            INSTALLING THE MAIL DOOR INTO PCBOARD                 20
  63.        Section 5.1  Mail Door Installation                       20
  64.        Section 5.2  PCBoard Menu and Conference Setup            22
  65.        Section 5.3  BWMAIL Command Line Parameters               24
  66.        Section 5.4  Multi-Node Installation Considerations       29
  67.        Section 5.5  Supported PCBoard Features                   30
  68.        Chapter 6
  69.            INSTALLING EXTERNAL PROGRAMS                          32
  70.        Section 6.1  Installing External Support Programs         32
  71.        Section 6.2  The PATH Environment Variable                32
  72.        Section 6.3  Configuring External Archiver Programs       33
  73.        Section 6.3.1  Macros Used for Archiver Definitions       34
  74.        Section 6.3.2  Sample Archiver Command Lines              35
  75.        Section 6.3.3  Notes About Archiver Command Lines         36
  76.        Chapter 7
  77.            OPERATING THE MAIL DOOR                               37
  78.        Section 7.1  General Mail Door Operation                  37
  79.        Section 7.2  Functions Available While a User is Online   37
  80.        Section 7.3  Maintaining The Blue Wave Mail Door          39
  81.        Section 7.3.1  Message Area Overrides                     39
  82.        Section 7.3.2  Removing Old User Records                  40
  83.        Section 7.4  Creating and Using Reader Bulletin Files     40
  84.        Section 7.5  Using the Mail Door in Local Mode            41
  85.        Section 7.6  The FidoNet->Internet Gateway                43
  86.        Chapter 8
  87.            SOFTWARE SUPPORT INFORMATION                          44
  88.  
  89.  
  90.                                          ------------------------------------
  91.                                          Chapter 1:  ABOUT THIS DOCUMENTATION
  92.                                          ------------------------------------
  93.  
  94.  
  95.        Section 1.1  Purpose of this Documentation
  96.  
  97.        The documentation presented in this file is designed to:
  98.  
  99.        * Provide an overview of the operation of The Blue Wave Offline Mail
  100.          Door from the SysOp or System Adminstrator's point of view, and the
  101.          concept of offline mail systems in general.
  102.  
  103.        * Provide information about the minimal system hardware configuration
  104.          that is required to use the mail door.
  105.  
  106.        * Provide details about the external programs which are required for
  107.          proper usage of the mail door, including the configuration of
  108.          these external programs.
  109.  
  110.        * Describe the features available in the mail door, and how to use
  111.          them effectively.
  112.  
  113.        The documentation  in this  file is  not meant as a reference for end-
  114.        users of  The Blue  Wave Offline  Mail Door.  A separate documentation
  115.        file describing  the use  of the  mail door  for  end-users  has  been
  116.        included in  a file  called BWDOOR.DOC.  The information in BWDOOR.DOC
  117.        applies to  all Blue Wave Mail Doors -- it is not specific to the mail
  118.        door for any single BBS software package.
  119.  
  120.        The mail door's configuration program (BWSETUP.EXE) provides an online
  121.        help system  which describes  each configuration  field in detail.  At
  122.        any point while using BWSETUP you can press the <F1> key for immediate
  123.        on-screen context sensitive help.
  124.  
  125.        If at any time you need help while using the mail door's configuration
  126.        utility, always  remember that documentation is only an <F1> key press
  127.        away.   The online  help system  provides 'hot  links' to related help
  128.        topics, and a help topic index to allow you to find items of interest.
  129.        In addition, each error message and condition that is generated by the
  130.        configuration utility  is covered  by an online help category.  If you
  131.        receive an  error message or condition while using BWSETUP, and you do
  132.        not know the cause of the problem, the help system will most likely be
  133.        able to  give you specific information about the cause and how you can
  134.        go about fixing it.
  135.  
  136.        This documentation  provides a Table of Contents; use this to help you
  137.        locate items  of interest in this file, or use a file viewer/editor to
  138.        search for items you may be looking for.
  139.  
  140.        Instructions for  printing this documentation file can be found in the
  141.        following section.
  142.  
  143.  
  144.  
  145.                  --------------------------------------------------
  146.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 3
  147.  
  148.  
  149.        Section 1.2  Printing this Documentation
  150.  
  151.        This documentation  is formatted  with Form  Feeds for printing on all
  152.        Personal Computer  printers.   This documentation file contains no IBM
  153.        Extended ASCII  characters, so  it should  print fine  on all  printer
  154.        models - even non IBM ProPrinter compatibles.
  155.  
  156.        To print this documentation in hard copy, simply execute the following
  157.        command from the DOS (or OS/2) command line:
  158.  
  159.             COPY BWMAIL.DOC PRN
  160.  
  161.        If you  would like  to print  this documentation  using the  PRINT.COM
  162.        print spooler  provided with most versions of DOS (and all versions of
  163.        OS/2), simply execute this command at the DOS or OS/2 prompt:
  164.  
  165.             PRINT BWMAIL.DOC
  166.  
  167.        The documentation  is formatted  to 60 lines per page so that printing
  168.        on laser  printers should  also work  with no  problems.  If, when you
  169.        attempt to  print this  documentation, your  printer  begins  ejecting
  170.        pages which  are not complete (the page number is not at the bottom of
  171.        the page),  you should cancel the print job and configure your printer
  172.        to accept  at least  60 lines per page.  You will need to consult your
  173.        printer's user manual for information on how this can be done.
  174.  
  175.        The documentation was written by George Hatchew and is Copyright (C)
  176.        1992-1996 by Cutting Edge Computing.  It may be distributed freely, so
  177.        long as  it is  kept together  with the entire set of mail door files.
  178.        Please read  the section  titled "Software License Agreement" for more
  179.        information.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.                  --------------------------------------------------
  205.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 4
  206.  
  207.  
  208.  
  209.                                        --------------------------------------
  210.                                        Chapter 2:  LICENSING AND DISTRIBUTION
  211.                                        --------------------------------------
  212.  
  213.  
  214.        Section 2.1  Software License Agreement
  215.  
  216.        Cutting Edge  Computing has  taken every  precaution to ensure that no
  217.        harm or  damage will  occur to  systems running  The Blue Wave Offline
  218.        Mail System.   However,  we cannot  be responsible  for any damages or
  219.        other losses  sustained as  a result  of running this software on your
  220.        system.   The user  assumes full  responsibility for the proper use of
  221.        this mail  system, whether  damage occurs as a fault of operator error
  222.        or software error.  NO WARRANTIES ARE IMPLIED OR EXPRESSLY STATED.
  223.  
  224.        The Blue  Wave Mail  System and  this  documentation  are  copyrighted
  225.        materials of  Cutting Edge Computing and George Hatchew.  Cutting Edge
  226.        Computing reserves  all rights  to these  materials, and  is protected
  227.        under United  States and  International Copyright  laws.   No part  of
  228.        these materials  may be  reproduced or modified in any way without the
  229.        prior express written permission of Cutting Edge Computing.
  230.  
  231.        Use of The Blue Wave Offline Mail System constitutes acceptance of the
  232.        stated terms  and conditions.   Cutting  Edge Computing  reserves  all
  233.        rights which are not expressly granted.
  234.  
  235.        The Blue  Wave Offline  Mail System  is fully copyrighted, and is not,
  236.        nor will it ever be, in the Public Domain.  The Blue Wave Offline Mail
  237.        System is  NOT FreeWare.   It  is distributed  and marketed  under the
  238.        concept of  ShareWare.   Users are  allowed to try this program for 30
  239.        days before  paying for  and registering  the mail system with Cutting
  240.        Edge Computing.   In this 30 days, you may use the program to its full
  241.        capacity.   If the  software does  not meet your needs, and you do not
  242.        plan on  purchasing and  registering this  software with  Cutting Edge
  243.        Computing after  your 30  day trial  period, you are to cease usage of
  244.        the mail  system.   Continued use  beyond  the  authorized  evaluation
  245.        period is  a violation  of copyright  law unless  you have  payed  the
  246.        registration fee in full.
  247.  
  248.        Cutting Edge  Computing  grants  an  unlimited  license  to  make  and
  249.        distribute UNREGISTERED  copies of  The Blue  Wave Offline Mail System
  250.        which have  been released  to the  public by  Cutting Edge  Computing.
  251.        Absolutely no  modifications to  the files  contained in  the software
  252.        package,  including  this  documentation  file,  may  be  made  before
  253.        distribution.  No fee may be charged by anyone other than Cutting Edge
  254.        Computing beyond the actual cost of providing these copies without the
  255.        prior written consent of Cutting Edge Computing.
  256.  
  257.        Distribution on CD-ROM, BBS systems, and other media is encouraged, so
  258.        long as the purchaser of the CD-ROM (and other media) or downloader of
  259.        the software  is aware  that they  must also purchase a LICENSE to use
  260.        this software.   The  purchase price  of the media or any subscription
  261.        costs to an online service do not pay for this license.
  262.  
  263.                  --------------------------------------------------
  264.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 5
  265.  
  266.        Section 2.2  Purchasing a License
  267.  
  268.        There are  several ways  in which  you  can  purchase  a  license  (or
  269.        register) to  use this  software.   Methods for  registration  include
  270.        surface mail, FAX registrations by credit card, and online credit card
  271.        registrations through our support BBS.
  272.  
  273.        When you  unpacked the  mail door and this documentation file from the
  274.        distribution archive,  four registration  forms should  have also been
  275.        unpacked.   The main registration form is called REGISTER.BW.  This is
  276.        a text file which can be printed in the same manner as described above
  277.        for printing this documentation.  Three other forms are also included.
  278.        REGISTER.AUS can  be used  to register  the software  if you  live  in
  279.        Australia, New  Zealand, Singapore,  or any other nearby country.  Our
  280.        registration agent  in Australia  is  Craig  Gibson  (Fidonet  address
  281.        3:620/252).   REGISTER.EUR can be used to register the software if you
  282.        live anywhere  in Europe.   Our  registration agent in Europe is Steve
  283.        Stacher (2:443/888).    REGISTER.RSA  may  be  used  to  register  the
  284.        software if  you live  anywhere in  Africa.  Our registration agent in
  285.        Africa is Graeme Slogrove (5:7107/4).
  286.  
  287.        To register  by  surface  mail,  simply  print  the  appropriate  form
  288.        (REGISTER.AUS for  Australia and  nearby  countries,  REGISTER.EUR  in
  289.        Europe, REGISTER.RSA  in Africa,  and  REGISTER.BW  elsewhere  in  the
  290.        world).   Complete all  of the necessary information and mail the form
  291.        to the address shown on the form.
  292.  
  293.        To register  by FAX,  you must  use a  credit card.   We  accept Visa,
  294.        MasterCard, Discover, American Express, Diner's Club, Optima, and JCB.
  295.        Complete the  form REGISTER.BW  and FAX  the form  to +1-810-743-5910.
  296.        Sorry, FAX  orders cannot  be accepted  at the Australian registration
  297.        agent.
  298.  
  299.        To register  through our support BBS, use a communications program and
  300.        your modem  to dial  +1-810-743-8464.   You must  be using  one of our
  301.        accepted credit  cards (Visa,  MasterCard, Discover, American Express,
  302.        Diner's Club,  Optima, or JCB).  When you log into the support BBS and
  303.        reach the  Main Menu, simply type 'R' to load the Registration System.
  304.        If your credit card authorization request is accepted by the bank, you
  305.        will immediately be provided a 'temporary' 30-day registration number.
  306.        After final  approval of  your credit  card order,  you will receive a
  307.        permanent registration  number via  surface  mail  (approximately  1-2
  308.        weeks).
  309.  
  310.        We perform  address verification on all credit card orders by phone or
  311.        through our  online registration  system.   If the address information
  312.        you provide  is not  accurate, our bank will decline the authorization
  313.        on your credit card.
  314.  
  315.        To register  by check  or money order, simply fill out the appropriate
  316.        registration form  and mail  it to  the address shown.  All checks and
  317.        money orders  MUST be payable in United States currency, and they MUST
  318.        be drawn  on a  US  bank.    EuroCheques  and  GiroCheques  cannot  be
  319.        accepted.   Due to  the fees our bank charges for cashing checks drawn
  320.        on a  Canadian bank,  we must  require that  you enclose an additional
  321.  
  322.                  --------------------------------------------------
  323.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 6
  324.  
  325.        $15.00 US  if you pay with a check from a Canadian bank.  We suggest a
  326.        Postal Money  Order, available  from your  local post office, instead.
  327.        This is a much cheaper alternative.
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.                  --------------------------------------------------
  382.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 7
  383.  
  384.        Section 2.3  Corporate and Governmental Purchase Orders
  385.  
  386.        Purchase orders  from large corporations and governmental agencies are
  387.        accepted with  "NET 30"  terms.    Both  site  licenses  and  per-copy
  388.        licenses are  available.   Please write to Cutting Edge Computing with
  389.        your requirements and we will submit a bid.  Site license and per-copy
  390.        discounts apply  when 25  or more copies of The Blue Wave Offline Mail
  391.        Reader and/or Blue Wave Offline Mail Door are purchased at one time.
  392.  
  393.        Our mailing address is:
  394.  
  395.        Cutting Edge Computing
  396.        P.O. Box 90476
  397.        Burton, MI  48509-0476  USA
  398.  
  399.  
  400.        Section 2.4  What You Receive When You Order
  401.  
  402.        When you  purchase a copy of The Blue Wave Offline Mail Door, you will
  403.        receive a  registration letter  which contains  details on  converting
  404.        your evaluation  copy of the mail door into a registered version.  The
  405.        registration letter  will assign you a unique user registration number
  406.        based upon  the SysOp name, and mail packet name you supplied when you
  407.        submitted your  registration form.   To  convert your copy of the mail
  408.        door into  a fully  licensed version,  you simply  need to  enter  the
  409.        registration name,  mail packet name, and registration number supplied
  410.        into the  "General Information"  section of  the BWSETUP program.  The
  411.        next time  you load  the  mail  door,  it  will  recognize  you  as  a
  412.        registered owner of the software.
  413.  
  414.        In order  to keep registration costs low, we do not automatically ship
  415.        a disk  containing a  copy of  the software.  Since you already HAVE a
  416.        copy of  the software,  we can  simply provide you with a registration
  417.        number to  activate the software license.  If you would like to insure
  418.        that you  have the latest version of the mail door, we do offer a disk
  419.        mailing service for an additional $5.00US.
  420.  
  421.        Sorry, we  currently do  not offer a printed manual for the mail door.
  422.        With the  online documentation/help  system built  into the  mail door
  423.        configuration utility, we have found that most users do not need or do
  424.        not want to pay the extra cost of providing a printed manual.
  425.  
  426.        Please be  sure to  keep the  registration letter you receive from us.
  427.        You may  need your  registration number  handy in  the case  of a disk
  428.        failure or  other system  crash.  This registration letter also serves
  429.        as your official software license.
  430.  
  431.        If  you   lose  or   otherwise  misplace  your  software  registration
  432.        certificate, we  can provide  you with  a replacement  copy.  You must
  433.        send your  request to our mailing address along with a self-addressed,
  434.        STAMPED envelope.  (Users outside of the United States must enclose an
  435.        International  Reply   Coupon,  available   at  your   post   office).
  436.        Replacement registration  codes will  NOT be  given by any other means
  437.        (FAX, e-mail, or voice technical support).
  438.  
  439.  
  440.                  --------------------------------------------------
  441.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 8
  442.  
  443.  
  444.        Section 2.5  Registered User License
  445.  
  446.        Registered users  of The  Blue Wave Offline Mail System are granted an
  447.        unlimited license to use the product, provided the following:
  448.  
  449.        *  Registration fees are NOT refundable.
  450.  
  451.        *  Registration codes are not transferable to other parties.
  452.  
  453.        *  Unofficial software patches must not be applied, and all copyright
  454.           notices in the documentation and supporting files are not to be
  455.           altered.
  456.  
  457.        *  Backup copies may be kept of all registered versions of this
  458.           software for archive purposes only.
  459.  
  460.        *  Use of a registered copy is limited to one machine at a time.  Use
  461.           of multiple registered copies on multiple machines AT THE SAME TIME
  462.           requires additional payment to Cutting Edge Computing.
  463.  
  464.  
  465.        Section 2.6  Trademarks and Credits
  466.  
  467.        Cutting Edge  Computing would like to thank all users of The Blue Wave
  468.        Offline Mail System for their outstanding contributions in the form of
  469.        new feature  requests, advice,  and word-of-mouth recommendations.  It
  470.        is users of the mail system that have made it what it is today.
  471.  
  472.        Cutting Edge  Computing extends credit to Scott J. Dudley for his work
  473.        in creating  the Squish  Message Base  Format and  the Squish  MSGAPI,
  474.        which is used in the code of The Blue Wave Mail Door in versions which
  475.        support the Squish Message Base Format.
  476.  
  477.        Cutting Edge  Computing extends credit to Joaquim Homrighausen, Andrew
  478.        Milner, Mats Birch, and Mats Wallin for their work in creating the JAM
  479.        message base  and the  JAM(mbp) API,  which is used in the code of The
  480.        Blue Wave  Mail Door  in versions  which support  the JAM Message Base
  481.        Format.
  482.  
  483.        The use  of these  APIs (Application  Programmer's Interfaces) ensures
  484.        maximum compatibility with the supported message base formats.
  485.  
  486.        Cutting Edge Computing would also like the thank all past  and current
  487.        software testers  for their  tireless and  extensive work in providing
  488.        problem reports and suggestions during the testing process.
  489.  
  490.        The following  products are  mentioned throughout  this documentation.
  491.        They are  products or  trademarks  of  the  companies  or  individuals
  492.        indicated:
  493.  
  494.             AMD                 Advanced Micro Devices
  495.             ARJ                 Robert Jung
  496.             Cyrix               Cyrix Corporation
  497.             DESQview            Quarterdeck Office Systems
  498.  
  499.                  --------------------------------------------------
  500.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 9
  501.  
  502.             FidoNet             Tom Jennings, Fido Software
  503.             IBM OS/2, PC-DOS    International Business Machines Corporation
  504.             Intel               Intel Corporation
  505.             Maximus             Scott Dudley, Lanius Corporation
  506.             MS-DOS, Windows     Microsoft Corporation
  507.             Opus-CBCS           Wynn Wagner, III
  508.             PCBoard             Clark Development
  509.             PKZIP/PKUNZIP       PKWARE, Incorporated
  510.             ProBoard            Philippe Leybaert
  511.             QuickBBS            Pegasus Software
  512.             RemoteAccess        Wantree Development
  513.             SuperBBS            Risto Virkkala and Aki Antman
  514.             T.A.G.              The T.A.G. Team
  515.             Telegard            Tim Strike
  516.             WildCat!            Mustang Development Corporation
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.                  --------------------------------------------------
  559.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 10
  560.  
  561.  
  562.  
  563.                                     -----------------------------------------
  564.                                     Chapter 3:  ABOUT THE BLUE WAVE MAIL DOOR
  565.                                     -----------------------------------------
  566.  
  567.  
  568.        Section 3.1  History of Offline Mail Systems
  569.  
  570.        Back in  the early  to mid  1980's, many  people were beginning to get
  571.        home computers and modems.  People began communicating in several ways
  572.        through Bulletin  Board Systems  (BBS's).   BBS systems began offering
  573.        message bases where people of similar interests could communicate with
  574.        each other  through electronic  means.  As the technology grew, people
  575.        started sharing message bases between different BBS systems across the
  576.        city, then  across the country, and eventually across the world.  Mail
  577.        conferencing was born, and nothing was going to stop it.
  578.  
  579.        At about  the same  time, commercial online services began offering E-
  580.        Mail services  which could  transmit a  message to a recipient several
  581.        thousands of  miles away  in a  matter  of  hours,  minutes,  or  even
  582.        seconds.   In the  early  stages,  however,  these  commercial  online
  583.        services were  very expensive.  E-Mail on commercial services normally
  584.        could only  be afforded  by businesses  and a  handful of individuals.
  585.        Many people became hooked, many others dependant, on E-Mail.
  586.  
  587.        While the commercial companies were developing newer, faster, and less
  588.        expensive ways  to transmit  E-Mail across  the  world,  so  were  the
  589.        amateur  BBS   operators.     Several  amateur   E-Mail  networks  and
  590.        technologies were  formed.  One of the largest amateur E-Mail networks
  591.        still popular today is FidoNet.
  592.  
  593.        Don't let  the term  'amateur' fool  you.  Many of the people that are
  594.        responsible for  keeping FidoNet  up and  running may be classified as
  595.        amateurs, but years of experience and knowledge, and usually thousands
  596.        of dollars in equipment, have earned them a very respectable name.
  597.  
  598.        Today, FidoNet  is nearly  35,000 nodes  strong and still growing!  As
  599.        the networks  and the number of home computer users has grown, the use
  600.        of technology  for reading  and replying  to E-Mail offline has become
  601.        more and  more essential.   When BBSing was young, there was plenty of
  602.        time to  read and  reply to  messages online.   Today, with more users
  603.        than ever  and more E-Mail flowing than ever, there just is not enough
  604.        time for  every user  to spend a half-hour, an hour, or even two hours
  605.        online to  their local BBS.  Long distance phone rates can also get to
  606.        be outrageously  expensive after  just a  few of  these  sessions  per
  607.        month.
  608.  
  609.        This is  where offline  mail reading  comes into  play.   With today's
  610.        innovations in  offline mail  processing, your  users can spend just a
  611.        very few minutes per day online to your BBS system and do all of their
  612.        work OFFLINE,  where there  is no system time limit to run up against,
  613.        and where  the phone  company's meter is not running.  This also frees
  614.        up your  system phone  line(s) for  access  by  more  users  and  help
  615.        alleviate the dreaded 'busy signals'.
  616.  
  617.                  --------------------------------------------------
  618.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 11
  619.  
  620.  
  621.        Best of all, users can read their mail at any time of the day or night
  622.        -- whenever  they have  free time.   Today's  communications  software
  623.        allows users  to build "smart" script files, which in turn allows them
  624.        to retrieve  their mail  automatically at even the oddest times of the
  625.        day or night (especially when long distance phone rates are low).
  626.  
  627.  
  628.        Section 3.2  What Are E-Mail Networks For?
  629.  
  630.        At this  point, you  may be  asking yourself, "What exactly are E-Mail
  631.        Networks for?".   Some people unfamiliar with mail networks and E-Mail
  632.        sometimes cannot  understand the enjoyment and knowledge that can come
  633.        out of being an active participant on an E-Mail network.  Not only can
  634.        you communicate with people from all corners of the world, but you can
  635.        learn more  about your  favorite computer software, share recipes with
  636.        others, learn  how to repair your leaking roof, get advice from others
  637.        on product  quality ratings,  or just  join in  a  chat  between  long
  638.        distance friends.  As a matter of fact, FidoNet alone offers well over
  639.        500 E-Mail  topics (sometimes called 'echos' or 'conferences') ranging
  640.        from Aardvarks to Zymurgy.
  641.  
  642.        Many businesses  now use  internal E-Mail  networks for communications
  643.        between employees  just down  the hall,  across town, or even half-way
  644.        around the  globe.   Many software and computer hardware companies now
  645.        have a support BBS which allows users to dial in and exchange messages
  646.        and files  between users.   Technical support is nearly always offered
  647.        through these types of support systems.
  648.  
  649.        If your  system is  not currently  part of  an E-Mail  network,  don't
  650.        worry.   The Blue Wave Offline Mail System will still provide you with
  651.        all of the features described.  And, if you later decide to join an E-
  652.        Mail network, you will already have The Blue Wave Offline Mail Door up
  653.        and running.  Very few, if any, changes will be necessary to integrate
  654.        the offline mail system into your E-Mail network.
  655.  
  656.  
  657.        Section 3.3  What Features are in Blue Wave?
  658.  
  659.        The Blue  Wave Offline  Mail Door  is unlike many offline mail systems
  660.        available today.
  661.  
  662.        The Blue  Wave Mail Door is tightly integrated with your BBS software.
  663.        This allows  the mail  door to have the same security features as your
  664.        BBS and  interface directly  with your  BBS's data  files.  This means
  665.        that The Blue Wave Mail Door requires very little to no maintenance by
  666.        the SysOp; just "plug it in and forget about it!"
  667.  
  668.        The mail  door allows  you to set default message areas for new users,
  669.        and force message areas on for all users or individual users.  Message
  670.        areas can  be blocked  on a  user-by-user basis,  allowing you greater
  671.        control and  flexibility in  managing access to specific message areas
  672.        on your system.
  673.  
  674.  
  675.  
  676.                  --------------------------------------------------
  677.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 12
  678.  
  679.        Full compatibility  with FidoNet EchoMail and NetMail message areas is
  680.        one of  the greatest features of the mail system.  If you are a member
  681.        of a  FidoNet-style network,  the mail  door offers full plug and play
  682.        compliance with  FidoNet standards.   Those BBS systems that support a
  683.        direct interface  for Internet  E-Mail and  Usenet Newsgroups are also
  684.        supported directly by The Blue Wave Mail Door.
  685.  
  686.        The Blue  Wave Mail  System offers a unique user Offline Configuration
  687.        system.   While the  user is using a Blue Wave-compatible mail reader,
  688.        they can  configure all  aspects of  the mail  door's  behavior  while
  689.        offline.   When the user uploads the offline configuration information
  690.        to the  mail door, the door automatically adjusts itself to the user's
  691.        new configuration  settings.  There is absolutely no setup required to
  692.        enable this feature.
  693.  
  694.        File Requesting is another option available to a user.  While offline,
  695.        a user may input a list of files that they would like to download from
  696.        your system.   The  next time  they use  the mail door to upload their
  697.        mail packet,  the door  automatically senses  the request for specific
  698.        files and  will send  them to  the user  as part  of their  next  mail
  699.        packet.   Full  record  checking  is  performed  during  file  request
  700.        sessions, including file access security, time limits, download:upload
  701.        ratios, and  any other  BBS-specific file  download options.   You can
  702.        control the  number of files that may be requested during one session,
  703.        or you may disable the file requesting feature entirely.
  704.  
  705.        As a  complement to  the file  requesting feature,  the mail door will
  706.        also perform  "new file  scanning."   If you  enable the new file scan
  707.        feature, users  will be  able to  choose the option of including a new
  708.        file listing  since their last mail download, or skipping the new file
  709.        scan altogether.
  710.  
  711.        One of  the more powerful features available to users is the Blue Wave
  712.        Bundling Commands.   Bundling  commands  allow  users  to  selectively
  713.        include, exclude,  and manipulate  the messages that are packed before
  714.        they actually  perform a mail download.  Please see the mail door user
  715.        documentation (BWDOOR.DOC)  for more  information about  this and many
  716.        other features available to users.
  717.  
  718.        The Blue  Wave Mail  Door is  one of  the  most  exciting  and  useful
  719.        utilities that you can add to your BBS.  It provides many benefits for
  720.        both SysOps  and users  alike.  After a while, you will wonder how you
  721.        ever managed without it!
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.                  --------------------------------------------------
  736.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 13
  737.  
  738.  
  739.  
  740.                                ----------------------------------------------
  741.                                Chapter 4:  HARDWARE AND SOFTWARE REQUIREMENTS
  742.                                ----------------------------------------------
  743.  
  744.  
  745.        Section 4.1  Different Blue Wave Mail Door Versions
  746.  
  747.        The Blue  Wave Offline  Mail Door  is available  in several  different
  748.        versions.  You should select the version that corresponds with the BBS
  749.        software that  you are  running.   Because each Blue Wave Mail Door is
  750.        more like  an extension  to your  BBS software,  rather than  just  an
  751.        external message  processing facility, it is vital that you select the
  752.        correct mail door to run on your system.
  753.  
  754.        It is  unlikely that  you will  be able  to use  a Blue Wave Mail Door
  755.        intended for  one specific  BBS  software  with  another  similar  BBS
  756.        software.   For example,  if you  are  running  SuperBBS,  it  is  not
  757.        possible to  run the  QuickBBS mail  door with  your software  -- even
  758.        though the  two BBS  software packages  are extremely  similar in both
  759.        operation and data file formats.
  760.  
  761.        At the  time this documentation was written, Blue Wave Mail Doors were
  762.        available for the following BBS software packages:
  763.  
  764.             * Maximus (DOS and OS/2)
  765.             * Opus
  766.             * PCBoard
  767.             * ProBoard
  768.             * QuickBBS
  769.             * RemoteAccess
  770.             * SuperBBS
  771.             * T.A.G.
  772.             * Telegard
  773.  
  774.        In addition,  a Blue  Wave Mail Door for the WildCat! BBS software was
  775.        scheduled to begin development in mid-1996.
  776.  
  777.        If you  would like  to obtain  any of these mail door versions, please
  778.        see Section  4.3 (Locating  Other Blue  Wave Versions)  for additional
  779.        information.
  780.  
  781.  
  782.        Section 4.1.1  Requirements for The Blue Wave Mail Door
  783.  
  784.        The Blue  Wave Mail  Door is  one of  the most  versatile  mail  doors
  785.        available.  The mail door will run on any IBM-PC Compatible computer--
  786.        whether it  be an XT or the latest Intel Compatible Processor.  At the
  787.        time of  this writing,  the Pentium  Pro was  the latest  Intel system
  788.        available.  Of course, the mail door will also run on Intel Compatible
  789.        chips such as the Cyrix and AMD offerings.
  790.  
  791.  
  792.  
  793.  
  794.                  --------------------------------------------------
  795.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 14
  796.  
  797.        The mail door will require approximately 200-300K of available memory.
  798.        The actual amount of memory required varies with the number of message
  799.        areas that are configured on your system.
  800.  
  801.        You will also need some hard disk space available.  The amount of hard
  802.        disk space varies greatly from system to system and from user to user.
  803.        While the  mail door  packs messages  into a  mail packet  for a user,
  804.        there will  need to  be enough  drive  space  available  to  hold  the
  805.        temporary files.   It  is unlikely  that you  will ever  need over  10
  806.        megabytes of  free disk  space available  for  temporary  files.    An
  807.        estimate in  the 2-3 megabyte range would not be far off target.  With
  808.        the mail  door's built-in  session limits  (see BWSETUP's  "Limits for
  809.        Mail Sessions"  menu option), you can control how many messages a user
  810.        may pack in any single mail session.  This will allow you to fine-tune
  811.        or limit the drive space that may be necessary at any one time.
  812.  
  813.        If you are running the OS/2 version of one of our mail doors, the same
  814.        requirements for  memory and disk space apply.  However, you will need
  815.        a system  capable of  running IBM  OS/2 v2.0  or higher.  This implies
  816.        that you  need at least an 80386SX processor with at least 4 megabytes
  817.        of memory.
  818.  
  819.  
  820.        Section 4.2  Different Blue Wave Reader Versions
  821.  
  822.        The Blue  Wave  Offline  Mail  Reader  v2.30  is  available  in  three
  823.        different versions.   There  is Blue Wave/DOS, Blue Wave/386, and Blue
  824.        Wave/OS2.   Each  mail  reader  has  the  same  set  of  features  and
  825.        operations available.   They  differ only in the operating system they
  826.        require, and  the amount of data they can handle.  (The amount of data
  827.        they can  handle is related to the operating system they are being run
  828.        under).
  829.  
  830.        The hardware  and  software  requirements  of  each  version  will  be
  831.        explained in  the following  three sections.    You  should  read  the
  832.        requirements for  each of  the three  different versions  of the  mail
  833.        reader to  be sure  that you  use the one that is most appropriate for
  834.        your system and your needs.
  835.  
  836.  
  837.        Section 4.2.1  Requirements for Blue Wave/DOS
  838.  
  839.        The Blue  Wave Offline  Mail Reader for DOS is by far the most popular
  840.        version of  the mail  reader.   It can  be  run  on  any  100%  IBM-PC
  841.        compatible computer  that runs  PC-DOS, MS-DOS,  or Novell DOS version
  842.        3.0 or  higher.   This includes  DOS emulation  in both  IBM OS/2  and
  843.        Microsoft Windows.  A minimum 1MB of free disk space is also needed.
  844.  
  845.        This software  will run  efficiently  on  any  Intel  8088  compatible
  846.        processor, which  includes the  IBM PC/XT,  IBM PC/AT, any Intel 80286
  847.        compatible processor, and processors compatible with the 80386, 80486,
  848.        and the Intel Pentium (such as an AMD or Cyrix processor).
  849.  
  850.        This version of the mail reader requires at least 300K of free memory,
  851.        and does not require the use of Expanded or Extended memory.  However,
  852.  
  853.                  --------------------------------------------------
  854.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 15
  855.  
  856.        due to  the limitation  of the  DOS operating system, this mail reader
  857.        cannot make  use of  any more than 640K of memory.  This limitation is
  858.        apparent in all DOS-based programs that operate in 'real' mode.  (Real
  859.        mode is a technical term that you probably do not have to worry about.
  860.        It is a term that, if you know what it means, you wish you didn't!).
  861.  
  862.        Because of  the limitations  of DOS  (the operating  system), the mail
  863.        reader is constrained to the limit of 640K of base memory.  This means
  864.        that, even though you may have 8 megabytes of memory in your computer,
  865.        DOS programs will only 'see' the first 640K.  This puts a limit on the
  866.        number of  message areas  and the number of messages per area that the
  867.        reader can  handle.   If you  are running an 80386 processor or higher
  868.        along with DOS or Windows, you may want to try the version of the mail
  869.        reader called  "Blue Wave/386".   Blue  Wave/386 can  'see' all of the
  870.        memory in  your computer  and use  it for  loading  large  numbers  of
  871.        messages and  message  areas,  in  addition  to  very  large  messages
  872.        (commonly encountered on the global Internet and USENET networks).
  873.  
  874.  
  875.        Section 4.2.2  Requirements for Blue Wave/386
  876.  
  877.        Blue Wave/386  is an extended, or protected mode DOS program.  In very
  878.        simple terms,  this means  that it  is capable of utilizing all memory
  879.        that is  installed on  your system.  (Please read the previous section
  880.        for more  information).   In addition to the ability to use all memory
  881.        in your computer, Blue Wave/386 can also 'simulate' memory through the
  882.        use of a disk file.  This is sometimes called a 'swap file' or Virtual
  883.        Memory.
  884.  
  885.        In order  to run Blue Wave/386 on your system, you must be running DOS
  886.        4.0 or  higher, OS/2  v2.0 or  higher, or  Windows v3.0 or higher.  In
  887.        addition, your computer processor must be at least an Intel compatible
  888.        80386, 80486,  or Pentium.   This  version of  the  mail  reader  also
  889.        requires more disk space than the rest.  A minimum of 2MB of free disk
  890.        space (more if a swap file is used) is needed.
  891.  
  892.        You must  also have  at least  1MB of  free memory  available on  your
  893.        system.   2MB of free memory is recommended for the fastest operation.
  894.        Through the  use of  both RAM  and swap  space (Virtual  Memory), Blue
  895.        Wave/386 can load thousands of message areas, thousands of messages in
  896.        an area,  and messages that are several megabytes long without batting
  897.        an eye.   Again, the only limit to Blue Wave/386 is the amount of real
  898.        memory plus  the amount of disk space you can give it.  It will handle
  899.        any mail packets you give it now and well into the future.
  900.  
  901.        For the technical wizards;  Blue Wave/386 will use a DPMI server, XMS,
  902.        EMS, or  VCPI interface to upper memory.  A DPMI server is recommended
  903.        (OS/2, Windows, and QEMM provide DPMI services).
  904.  
  905.        This version  is NOT  recommended if  you are running OS/2.  Protected
  906.        mode switching  in this mail reader will consume an undesirable amount
  907.        of processor  time.   OS/2 users  should choose Blue Wave/OS2 as their
  908.        mail reader.   This version is also NOT recommended for users who rely
  909.        on the  speech hardware/software interface in Blue Wave/DOS.  Although
  910.        this version  of the  mail reader does provide a speech-friendly video
  911.  
  912.                  --------------------------------------------------
  913.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 16
  914.  
  915.        mode, it  is extremely  slow.  This is due to the fact that writing to
  916.        the PC-BIOS requires a switch from protected mode to real mode.  Since
  917.        PC-BIOS compatible  video writes  can only  be done one character at a
  918.        time, this causes a severe performance penalty.
  919.  
  920.        Blue Wave/386 utilizes the DOS4GW protected mode runtime loader.  This
  921.        DOS extender may exhibit some incompatibilities on some hardware.  The
  922.        author has  one such  machine.   It is  highly  recommended  that  you
  923.        install and use this version before blindly purchasing a copy as there
  924.        is a  slight chance  that it  may not work for you.  Sorry, no refunds
  925.        can be given once you receive a registration number.
  926.  
  927.  
  928.        Section 4.2.3  Requirements for Blue Wave/OS2
  929.  
  930.        Blue Wave/OS2  has no  special hardware requirements, other than those
  931.        required to  run OS/2 itself.  If you are running OS/2 v2.0 or higher,
  932.        this mail reader will most likely work for you.
  933.  
  934.        Blue Wave/OS2  has all  of the  features and options available in Blue
  935.        Wave/DOS and  Blue Wave/386.   It  is a 32-bit text mode program which
  936.        can either  be run full-screen or on the OS/2 desktop.  (It is *not* a
  937.        Presentation Manager application.)
  938.  
  939.        As with  Blue Wave/386, Blue Wave/OS2 can handle any number of message
  940.        areas, any  number of  messages in an area, and messages of nearly any
  941.        length.   The only  limit is the amount of memory that OS/2 can supply
  942.        to the mail reader.  (The available memory is limited to the amount of
  943.        actual RAM  installed on  your computer,  plus the amount of free disk
  944.        space available  to the  OS/2 swap  file).   As  with  the  other  two
  945.        versions of  the mail reader, Blue Wave/OS2 is very efficient with its
  946.        memory usage.  Considering this fact, and assuming available swap file
  947.        space of  approximately 3  megabytes, there  is  nothing  this  reader
  948.        *won't* load!   An  average sized mail packet probably would cause the
  949.        mail reader to not use any more than 300K of system memory resources.
  950.  
  951.        Although Blue  Wave/DOS runs extremely well in an OS/2 DOS session, it
  952.        is recommended  that you  use the native OS/2 mail reader if possible.
  953.        There is  much less of a performance hit on other running applications
  954.        when using native OS/2 software.
  955.  
  956.  
  957.        Section 4.3  Locating Other Blue Wave Versions
  958.  
  959.        All Blue Wave Offline Mail Reader and Door versions are distributed as
  960.        ShareWare.   If you  would like  to try  a version of the mail door or
  961.        reader but  cannot find a copy locally, or you would like to make sure
  962.        you obtain  an unaltered  distribution file, here are some alternative
  963.        methods for getting an evaluation copy:
  964.  
  965.        *    The latest  versions of  our software  are always  available  for
  966.             first time  callers to  download through  our support  BBS.   Our
  967.             support BBS phone number is +1-810-743-8464.
  968.  
  969.  
  970.  
  971.                  --------------------------------------------------
  972.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 17
  973.  
  974.        *    You can  receive a  disk directly  from Cutting Edge Computing by
  975.             sending $5.00  (US Dollars)  to our  mailing address given on the
  976.             title page  of this  documentation.  Please specify 3.5" or 5.25"
  977.             disk size  and the  version(s) of the mail door and/or reader you
  978.             would like.   You can use the file REGISTER.BW, which should have
  979.             been included in the mail door distribution archive, to a request
  980.             a disk.
  981.  
  982.        *    If you have Internet access, the latest version of the mail doors
  983.             and mail  readers are always available through our World Wide Web
  984.             Site.  Simply point your web browser to:
  985.  
  986.                         http://www.concentric.net/~bluewave.
  987.  
  988.  
  989.        *    We try  to keep the latest versions of the mail reader on America
  990.             Online.  Use the file finder to search for "Blue Wave".
  991.  
  992.  
  993.        Section 4.4  Required External Programs
  994.  
  995.        When a  user downloads message packets from your BBS system, they will
  996.        always be  compressed with  some type  of compression  program.    The
  997.        program used  to compress  these mail  packets is  sometimes called an
  998.        archiver, or  compression utility.   We  would be  willing to hazard a
  999.        guess that  95% or  more of  the mail systems online today support the
  1000.        use of  a ZIP-format  compatible archiver.   It  is suggested that you
  1001.        obtain a  ZIP compression  and decompression  program.  Without these,
  1002.        your mail door probably will be unable to communicate with many of the
  1003.        mail readers available today.
  1004.  
  1005.        The most  popular ZIP compression and decompression programs come from
  1006.        the author  and creator of the ZIP archive format;  Phil Katz, founder
  1007.        of PKWARE,  Inc.   PKZIP and PKUNZIP are distributed in the same file,
  1008.        normally called  PKZ204G.EXE.   (At the  time this  documentation  was
  1009.        written, v2.04g  of PKZIP/PKUNZIP  was the  latest version available).
  1010.        PKZIP and  PKUNZIP are  ShareWare programs,  and are almost definitely
  1011.        available from the same source you received The Blue Wave Offline Mail
  1012.        Door.   Blue Wave  is  distributed  through  BBS  systems  and  online
  1013.        services in  the ZIP  compression format,  so it  is likely  that  you
  1014.        already have a copy.
  1015.  
  1016.        InfoZip is  another PKZIP  compatible archive  program.    InfoZip  is
  1017.        released with source code, and is available for download from many BBS
  1018.        systems.  These programs are usually named ZIP.EXE and UNZIP.EXE.  The
  1019.        InfoZip  utilities  are  available  for  several  different  operating
  1020.        systems including  DOS and OS/2.  (OS/2 users should get a copy of the
  1021.        OS/2 flavor of InfoZip for use with Blue Wave/OS2).
  1022.  
  1023.        If you  cannot find  a copy  locally, you  are welcome to download the
  1024.        above utilities  from the  Blue Wave  Support BBS  from the "Blue Wave
  1025.        Reader" file directory (Area #1).
  1026.  
  1027.  
  1028.        Section 4.5  MS-DOS CONFIG.SYS Settings
  1029.  
  1030.                  --------------------------------------------------
  1031.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 18
  1032.  
  1033.  
  1034.        If you  are using  the mail  door under  the  MS-DOS  (or  compatible)
  1035.        operating system  -- either  alone or  with Microsoft  Windows --  you
  1036.        should make  sure that  the following  items are  set properly in your
  1037.        CONFIG.SYS file.
  1038.  
  1039.        CONFIG.SYS is  a system  startup configuration  file  that  is  always
  1040.        located  in  the  root  directory  of  the  DOS  boot  drive  (usually
  1041.        C:\CONFIG.SYS).   If you  do not  have a  CONFIG.SYS file,  it will be
  1042.        necessary to create one.
  1043.  
  1044.        Load CONFIG.SYS  into a  text editor  and make  sure there  is a  line
  1045.        somewhere which reads:
  1046.  
  1047.             FILES=25
  1048.  
  1049.        This line  tells DOS  at boot time to allocate 25 file handles for use
  1050.        by programs  that you  will be running on your system.  If you already
  1051.        have a "FILES=" line in your CONFIG.SYS, and the number after it is 25
  1052.        or higher,  there will  be no  problems.   A value higher than 25 will
  1053.        work just  fine, but  a lower  value can  cause problems.  If the mail
  1054.        door attempts to open a file for reading or writing, and there are not
  1055.        enough DOS file handles available, the open will fail.
  1056.  
  1057.        The last  item to  check in  your CONFIG.SYS  file is  the  number  of
  1058.        buffers that  you  are  allowing  DOS  to  allocate  for  faster  disk
  1059.        accesses.   In your  CONFIG.SYS file,  you should  have  a  line  that
  1060.        contains the following:
  1061.  
  1062.             BUFFERS=30
  1063.  
  1064.        This tells  DOS to  allocate enough  system memory  to  hold  30  disk
  1065.        buffers.  This in turn allows DOS to perform disk intensive activities
  1066.        much more  quickly than  normal.   If the  number of  buffers in  your
  1067.        CONFIG.SYS file is already set higher than 30, that is perfectly fine.
  1068.        If you are running a disk caching program, you can ignore this advice,
  1069.        and follow  the instructions  that were given in the documentation for
  1070.        your disk  caching program.   Most disk caching programs will instruct
  1071.        you to use a very low value for the "BUFFERS=" statement in CONFIG.SYS
  1072.        because the  cache program can use the memory in a much more efficient
  1073.        manner than DOS does.
  1074.  
  1075.        If you  have made  changes to your CONFIG.SYS file, please remember to
  1076.        reboot your system so that the new settings will take effect.
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.                  --------------------------------------------------
  1090.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 19
  1091.  
  1092.  
  1093.  
  1094.                             -------------------------------------------------
  1095.                             Chapter 5:  INSTALLING THE MAIL DOOR INTO PCBOARD
  1096.                             -------------------------------------------------
  1097.  
  1098.  
  1099.        Section 5.1  Mail Door Installation
  1100.  
  1101.        The mail  door is distributed in an archive called BWnnnPCB.ZIP, where
  1102.        "nnn" is  the version  number of  the mail  door.  In BWnnnPCB.ZIP you
  1103.        will find  this documentation file, any necessary conversion programs,
  1104.        and a  README.1ST file.    Please  --  always  be  sure  to  view  the
  1105.        README.1ST file before attempting to install the mail door!
  1106.  
  1107.        If you  are upgrading  from a previously-installed version of the mail
  1108.        door, installation/upgrade  instructions will  always be  found in the
  1109.        README.1ST file.  The installation instructions in this section of the
  1110.        documentation apply to new installations only.
  1111.  
  1112.        All of  the base  mail door  files (on-line  help files,  introductory
  1113.        screens, BWSETUP.EXE,  BWMAIL.EXE, and  BWMAIL.OVR) are  contained  in
  1114.        another archive  called BW_DOS.ZIP  (DOS version)  or BW_OS2.ZIP (OS/2
  1115.        version).   Create a  new directory specifically for the mail door; we
  1116.        recommend a  directory under  your PCBoard BBS installation directory,
  1117.        such as C:\PCB\BWMAIL.
  1118.  
  1119.  
  1120.        1)   Unpack BW_DOS.ZIP  (if you  are installing  the DOS  version)  or
  1121.             BW_OS2.ZIP (if you are installing the OS/2 version) into the mail
  1122.             door directory.
  1123.  
  1124.        2)   Change to  the mail  door directory  and  run  BWSETUP  (DOS)  or
  1125.             BWSETUP2 (OS/2).   (This file should have been unpacked in step 1
  1126.             above.)   This will load the door's installation module and guide
  1127.             you through  the initial  setup procedures.   You  will first  be
  1128.             prompted to enter the path and file name of (one of) your PCBoard
  1129.             system configuration files.  This is normally called PCBOARD.DAT,
  1130.             and is  normally  located  in  the  C:\PCB  directory.    If  the
  1131.             installation module can open the PCBOARD.DAT file you specify, it
  1132.             will load  as much  information as  possible from  your  existing
  1133.             PCBoard configuration.
  1134.  
  1135.        3)   Each conference  that you have defined in PCBoard will be used by
  1136.             the mail  door EXACTLY  as it is defined with PCBSetup.  The mail
  1137.             door reads  all conference  definitions directly  from  PCBoard's
  1138.             CNAMES.@@@ and  CNAMES.ADD configuration  files.   This  includes
  1139.             security levels,  conference types,  and message  file locations.
  1140.             (Please note  that the  terms "conference" and "message area" are
  1141.             used throughout  this documentation.  Both refer to "conferences"
  1142.             as they are defined within the PCBoard documentation.)
  1143.  
  1144.        4)   After a  few moments,  BWSETUP will  ask you  for the name of the
  1145.             mail packets  that you  would like  the mail door to create.  The
  1146.             name you  give here  should be  unique, and  should help identify
  1147.  
  1148.                  --------------------------------------------------
  1149.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 20
  1150.  
  1151.             your BBS  to your users.  For example, if your BBS is called "The
  1152.             Wild!  Blue   BBS",  you  might  use  the  mail  packet  name  of
  1153.             "WILDBLUE".   If your  BBS is named "The I/O Bus", you might want
  1154.             to use  the mail  packet name  of "IOBUS".   The  mail door  will
  1155.             generate mail  packet file names such as WILDBLUE.001, IOBUS.QWK,
  1156.             or WILDBLUE.TU2.   (Sorry,  but you  cannot use  the mail  packet
  1157.             identifier of  "BLUEWAVE"!)  Because the mail packet name is used
  1158.             as a  basis for  your registration  number (when you register the
  1159.             mail door with Cutting Edge Computing), you should make sure that
  1160.             it is a close match to your BBS or system name.
  1161.  
  1162.        5)   After you  have selected a mail packet name, BWSETUP will ask you
  1163.             whether or  not you  would like to automatically add an entry for
  1164.             the mail  door to your PCBoard DOORS.LST file.  We recommend that
  1165.             you allow  BWSETUP to  create a DOORS.LST entry for you; however,
  1166.             if you  do not want BWSETUP to edit your DOORS.LST file, you will
  1167.             need to  do so  manually at a later time (please see Section 5.2,
  1168.             "PCBoard Menu and Conference Setup", for complete details).
  1169.  
  1170.             If you  choose to  allow BWSETUP to edit your DOORS.LST file, you
  1171.             need to  confirm the  Door File  Name, Security Required, and the
  1172.             exact name of your DOORS.LST file.
  1173.  
  1174.             a)   The "Door File Name" field is the name that PCBoard will use
  1175.                  to identify  this particular  door.   The  default  name  is
  1176.                  "BLUEWAVE", but  you may  wish to name it something similar,
  1177.                  such  as   "BW"  or   "BWAVE".     A  user   may  then  type
  1178.                  "OPEN;BLUEWAVE" or  "OPEN;BW" while at the PCBoard main menu
  1179.                  to go directly into the mail door.
  1180.  
  1181.             b)   The "Security  Required" field  is simply the security level
  1182.                  needed to  access the  mail door from PCBoard's menu system.
  1183.                  Any PCBoard  security level  between 0  (all users)  and 255
  1184.                  (SysOp) may be entered here.
  1185.  
  1186.             c)   The "DOORS.LST  Name" field  is retrieved  from your PCBoard
  1187.                  Main Board  Configuration information.  This file contains a
  1188.                  list of  doors on  your system and allows you to define such
  1189.                  things as  security levels  and the  type of  door  you  are
  1190.                  installing.
  1191.  
  1192.             After you  have verified  and/or edited  each field, simply press
  1193.             <F10> to  continue  --  BWSETUP  will  add  this  entry  to  your
  1194.             DOORS.LST file.   PLEASE  NOTE:  You will still need to edit your
  1195.             PCBoard DOORS  display menu  to include  an entry  for Blue Wave.
  1196.             Because  this  is  an  ANSI-type  display  file,  BWSETUP  cannot
  1197.             automatically do this for you.
  1198.  
  1199.        6)   BWSETUP will  display a screen informing you that it has gathered
  1200.             as much  data as  possible from  your PCBoard  installation.  The
  1201.             installation program  also installed  several sample archiver and
  1202.             protocol configurations into your the mail door.  At this time it
  1203.             will be  necessary to  "walk" through  *each* menu  item  of  the
  1204.             installation  and   maintenance  utility   in  order   to   enter
  1205.             information that  cannot be  found through  your  PCBoard  setup.
  1206.  
  1207.                  --------------------------------------------------
  1208.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 21
  1209.  
  1210.             Each menu  item in  the BWSETUP  program is  described in  detail
  1211.             through online  help.   If you  need help at any time while using
  1212.             BWSETUP, please press <F1>.  The help system is context sensitive
  1213.             and provides links to other related help topics.
  1214.  
  1215.        7)   At this point your new mail door has been installed.  Now it will
  1216.             be necessary  to edit your PCBoard DOORS display menu in order to
  1217.             add an  entry for  The Blue Wave Mail Door.  If you are running a
  1218.             multi-node system,  other setup procedures may also be necessary.
  1219.             Please read  this entire chapter to determine what changes to the
  1220.             default mail door configuration may be required.
  1221.  
  1222.  
  1223.        Section 5.2  PCBoard Menu and Conference Setup
  1224.  
  1225.        If you have installed other external programs into your PCBoard setup,
  1226.        you should  have absolutely  no problem  installing The Blue Wave Mail
  1227.        Door.   If you  have never  installed external programs into your BBS,
  1228.        don't worry.  This section will guide you through the process and have
  1229.        you back up and running in no time at all.
  1230.  
  1231.        1)   Create a  file called  "BLUEWAVE" in  your mail  door  directory.
  1232.             This is  a batch  file that PCBoard uses to execute the mail door
  1233.             when a  user is online; it is also the command the user will type
  1234.             when they  execute the  PCBoard "DOOR"  command.  The file should
  1235.             normally contain the following lines:
  1236.  
  1237.                  @ECHO OFF
  1238.                  C:
  1239.                  CD \PCB\BWMAIL
  1240.                  BWMAIL.EXE /PCBDAT=%PCBDAT% /PCBUSER=%PCBDRIVE%%PCBDIR%
  1241.                  IF "%INPCB%"=="Y" EXIT
  1242.                  %PCBDRIVE%
  1243.                  CD %PCBDIR%
  1244.                  BOARD
  1245.  
  1246.             The batch  file uses  the various environment variables set up by
  1247.             PCBoard (PCBDAT,  PCBDRIVE, etc.), thus no changes should need to
  1248.             be made  to most  of this  file.   The only  changes that  may be
  1249.             needed are  to lines  two and three, which must specify the drive
  1250.             and  path   of  your   mail  door  directory.    Also  note  that
  1251.             "BWMAIL.EXE" should  be changed to "BWMAIL2.EXE" if you are using
  1252.             the OS/2 version of the mail door.
  1253.  
  1254.             Note that this file can actually be called anything you wish, but
  1255.             should (for  the sake  of simplicity)  reflect the purpose of the
  1256.             program  being   executed  --   "BWAVE"  and   "MAIL"  are   good
  1257.             alternatives.  IF YOU USE A NAME OTHER THAN "BLUEWAVE", make sure
  1258.             you substitute  "BLUEWAVE" with the name you are using throughout
  1259.             the rest of this procedure.
  1260.  
  1261.             (If you're  wondering why  the batch file doesn't end with a .BAT
  1262.             or .CMD  extension, it's  because  PCBoard  actually  copies  the
  1263.             contents of  this file  into a  larger  "master"  batch  file  it
  1264.             creates during  the process of executing an external program.  As
  1265.  
  1266.                  --------------------------------------------------
  1267.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 22
  1268.  
  1269.             such, the  file doesn't  need an  extension, and in fact, it MUST
  1270.             NOT have an extension.)
  1271.  
  1272.        2)   Run PCBSetup  and select  Main Board  Configuration.    Move  the
  1273.             cursor to  the Doors Path/Name List File and press <F2>.  This is
  1274.             where you  will add  the item  to the  PCBoard DOORS listing that
  1275.             will execute  the mail door.  Press <Alt-I> to insert a new item,
  1276.             and configure the fields as follows:
  1277.  
  1278.                  Filename:                BLUEWAVE
  1279.                  Password:                (none - leave blank)
  1280.                  Sec:                     0
  1281.                  Login:                   N
  1282.                  USERS.SYS:               Y
  1283.                  DOOR.SYS:                N
  1284.                  Shell:                   N (if running DOS version)
  1285.                                           F (if running OS/2 version)
  1286.                  OS/2: (**)               N (if running DOS version)
  1287.                                           Y (if running OS/2 version)
  1288.                  Charges Per Minute:      0
  1289.                  Charges Per Use:         0
  1290.                  Path to DOOR Files:      C:\PCB\BWMAIL
  1291.  
  1292.             Afterwards, press <ESC> to save the changes.
  1293.  
  1294.             The "Shell"  field tells  PCBoard how  to exit itself in order to
  1295.             execute an  external program.   This  field should  be set to "N"
  1296.             under  the   DOS  version,   and  "F"  under  the  OS/2  version.
  1297.             (Specifying "F"  tells PCBoard  to leave  the communications port
  1298.             "hot" so that the mail door can "grab" the port for its own use.)
  1299.  
  1300.             The "OS/2" field tells PCBoard that the program being executed is
  1301.             a native OS/2 program.  This field should be set to "N" under the
  1302.             DOS version,  and "Y"  under the OS/2 version.  Note that the DOS
  1303.             version of  PCBoard ignores any entry with this field set to "Y",
  1304.             so make  sure the  field is  properly set!   (This option is only
  1305.             available under PCBoard version 15.22 and later.)
  1306.  
  1307.             The "Path  to DOOR  Files" tells  PCBoard where the program being
  1308.             executed is  stored -- specifically, it informs PCBoard where the
  1309.             batch file  created in  Step 1 is located -- and should be set to
  1310.             point to the mail door directory.
  1311.  
  1312.             NONE OF  THE OTHER FIELDS SHOULD BE ALTERED EXCEPT BY EXPERIENCED
  1313.             PCBOARD SYSOPS!    MAKING  CHANGES  WITHOUT  UNDERSTANDING  THEIR
  1314.             EFFECT CAN CAUSE THE MAIL DOOR TO CEASE OPERATING PROPERLY!
  1315.  
  1316.        3)   At the  Main Board  configuration screen,  move the cursor to the
  1317.             Doors Menu  Listing field  and press <F2>.  This is the text file
  1318.             that is  displayed by  PCBoard when  a user types the "DOOR" menu
  1319.             command, and  should be  updated to  add the  command  needed  to
  1320.             execute the  mail door ("BLUEWAVE") and a description of the door
  1321.             itself.  Consult the PCBoard documentation for information on how
  1322.             to modify this file, as a description of this procedure is beyond
  1323.             the scope of this documentation.
  1324.  
  1325.                  --------------------------------------------------
  1326.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 23
  1327.  
  1328.  
  1329.        4)   Press <ESC>  to return to the PCBSetup main menu, and press <ESC>
  1330.             again to save the changes to your PCBoard configuration.
  1331.  
  1332.        If you  followed these  instructions exactly, the mail door should now
  1333.        be ready  for use.   To  test your setup, simply log into your BBS and
  1334.        select the new menu item you placed into the system.  If the mail door
  1335.        fails to  execute properly,  check the PCBoard log file and the BW.LOG
  1336.        file for  clues as  to what  went wrong.  You may want to carefully go
  1337.        over the  installation instructions once again to make sure you didn't
  1338.        miss anything.
  1339.  
  1340.        If you  are running a multi-node PCBoard system, please continue on to
  1341.        the section titled "Multi-Node Installation Considerations".
  1342.  
  1343.        If you  are interested  in using  The Blue  Wave Mail  Door for  local
  1344.        downloads and uploads, please see Chapter 7.
  1345.  
  1346.  
  1347.        Section 5.3  BWMAIL Command Line Parameters
  1348.  
  1349.        The Blue  Wave Mail  Door accepts  several command  line parameters in
  1350.        order for  you to  override certain  settings and defaults within your
  1351.        BWMAIL.PRM  configuration   file.     Command  line   parameters  take
  1352.        precedence over  all settings,  including environment  variables.  The
  1353.        following is a description of all available command line parameters.
  1354.  
  1355.        Although all  command line  parameters described here are shown with a
  1356.        dash ("-")  preceding them,  a forward  slash ("/")  may also be used.
  1357.        Also, parameters may be entered in either upper or lower case.
  1358.  
  1359.  
  1360.        Location of USERS.SYS File (-PCBUSER=)
  1361.        --------------------------------------
  1362.             When the  door is  executed from within PCBoard, a USERS.SYS
  1363.             file is generated.  This file contains information about the
  1364.             user, and  is required by the door.  The -PCBUSER= parameter
  1365.             is used to specify the directory where the USERS.SYS file is
  1366.             stored.  Normally, this information can be obtained by using
  1367.             the PCBDRIVE  and PCBDIR  environment  variables;  as  such,
  1368.             specifying:
  1369.  
  1370.                  -PCBUSER=%PCBDRIVE%%PCBDIR%
  1371.  
  1372.             in your batch file will usually take care of the matter.
  1373.  
  1374.             Note that  this parameter  is usually  not needed when using
  1375.             the -K  parameter (described  below) to  execute the door in
  1376.             local  mode,  as  the  door  will  already  know  where  the
  1377.             USERS.SYS file is located in local mode.
  1378.  
  1379.             USAGE  :  -PCBUSER=<path to USERS.SYS file>
  1380.             DEFAULT:  Required unless in local mode.
  1381.  
  1382.  
  1383.  
  1384.                  --------------------------------------------------
  1385.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 24
  1386.  
  1387.        Location of PCBOARD.DAT File (-PCBDAT=)
  1388.        ---------------------------------------
  1389.             The PCBOARD.DAT file contains information about your PCBoard
  1390.             system, and  must be  loaded by  the door.   If your PCBoard
  1391.             system is  set up to share a single PCBOARD.DAT file between
  1392.             nodes, this  parameter is not needed, as the door can obtain
  1393.             this information from the BWMAIL.PRM file.
  1394.  
  1395.             If your  system is set up to use a separate PCBOARD.DAT file
  1396.             for each  node, however,  then  the  -PCBDAT=  parameter  is
  1397.             required  in   order  for  the  door  to  load  the  correct
  1398.             PCBOARD.DAT file  for each node.  Normally, this information
  1399.             is stored  in the  PCBDAT  environment  variable;  as  such,
  1400.             specifying:
  1401.  
  1402.                  -PCBDAT=%PCBDAT%
  1403.  
  1404.             in your batch file will usually take care of the matter.
  1405.  
  1406.             Note that  the requirement for the door to know the location
  1407.             of PCBOARD.DAT  applies to  both remote  users and  to local
  1408.             mode (the -K parameter, described below).  Keep this in mind
  1409.             when creating batch files to execute the door in local mode.
  1410.  
  1411.             USAGE  :  -PCBDAT=<path to PCBOARD.DAT file>
  1412.             DEFAULT:  Path defined within BWMAIL.PRM.
  1413.  
  1414.  
  1415.        BWMAIL.PRM Override (-C)
  1416.        ------------------------
  1417.             Multi-line users may wish to maintain separate Blue Wave PRM
  1418.             files, one  for each  node.   By default, the door will load
  1419.             BWMAIL.PRM.   If you  use the -C parameter, you can override
  1420.             this default.  The command line:
  1421.  
  1422.                  BWMAIL -cLINE2.PRM
  1423.  
  1424.             would load the door's parameter file called LINE2.PRM.
  1425.  
  1426.             If you  wish to  maintain separate  PRM files between nodes,
  1427.             you can  edit others  with BWSETUP by specifying the name of
  1428.             the configuration  file on  the command  line.  For example,
  1429.             "BWSETUP LINE2.PRM"  would allow  you to edit the parameters
  1430.             in "LINE2.PRM".
  1431.  
  1432.             USAGE  :  BWMAIL -C<name of PRM file>
  1433.             DEFAULT:  BWMAIL.PRM.
  1434.  
  1435.  
  1436.        Port Override (-P)
  1437.        ------------------
  1438.             By default,  the door uses the port number (comm port handle
  1439.             under OS/2)  contained within  the USERS.SYS  file  that  is
  1440.             loaded during initialization.  If, for some reason, you need
  1441.             to override this value, use the -P parameter.
  1442.  
  1443.                  --------------------------------------------------
  1444.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 25
  1445.  
  1446.  
  1447.             DOS VERSION  ONLY:   If you  are using  a FOSSIL driver, you
  1448.             should specify  the FOSSIL  port number  (by  default,  Port
  1449.             0=COM1, Port  1=COM2, and so on).  The door will support any
  1450.             port that  you  would  like  to  use,  as  long  as  it  can
  1451.             communicate with  your FOSSIL  driver.   If  you  are  using
  1452.             direct async  or "OS/2  under DOS"  comm  port  access,  you
  1453.             should specify  the  COM  port  number  (Port  1=COM1,  Port
  1454.             2=COM2, and so on).
  1455.  
  1456.             OS/2 VERSION  ONLY:   The value  specified with -P should be
  1457.             the comm  port handle.   PCBoard  stores this  value in  the
  1458.             PCBHANDLE environment  variable.   Most OS/2 users will have
  1459.             no use  for this  option, as  the comm  port handle  is  not
  1460.             normally available to users.
  1461.  
  1462.             USAGE  :  BWMAIL -P<port number or handle>
  1463.             DEFAULT:  Value in USERS.SYS file loaded by the door.
  1464.  
  1465.  
  1466.        Task/Node Number Override (-T)
  1467.        ------------------------------
  1468.             By default,  the door  uses the task number contained within
  1469.             the PCBOARD.SYS  file loaded during initialization.  If, for
  1470.             some reason,  you need  to override  this value,  use the -T
  1471.             parameter.     (The  door   uses  this  information  in  the
  1472.             translation of  the "%N"  and "%T" macros in the Directories
  1473.             and File  Paths editor  of BWSETUP.)  The task number *must*
  1474.             correspond to  the user's task number within the BBS, or the
  1475.             door will  load the wrong information about the current user
  1476.             or cause SHARE violations.
  1477.  
  1478.             Note that  the -T parameter is ignored if the door is run in
  1479.             local mode (the task number is forced to "0").
  1480.  
  1481.             USAGE  :  BWMAIL -T<task/node number>
  1482.             DEFAULT:  Value in PCBOARD.SYS file loaded by the door.
  1483.  
  1484.  
  1485.        Local User Logon (-K)
  1486.        ---------------------
  1487.             The -K  parameter is  used to  automatically load a selected
  1488.             user out  of PCBoard's  user file  and log  them in locally.
  1489.             This method  allows the  use of the mail door without having
  1490.             to first  log into  the BBS.   The  best use  for this is to
  1491.             bundle mail  for the  SysOp or  other users that may want to
  1492.             use The  Blue Wave Offline Mail System.  The -K parameter is
  1493.             described in  greater detail  in Chapter 7, "Local Mail Door
  1494.             Usage".
  1495.  
  1496.             USAGE  :  BWMAIL -K<user logon information>
  1497.             DEFAULT:  None.
  1498.  
  1499.  
  1500.        Local Color Output Override (-MONO)
  1501.  
  1502.                  --------------------------------------------------
  1503.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 26
  1504.  
  1505.        -----------------------------------
  1506.             The door  will always output color to the local screen, even
  1507.             if  the   remote  user  has  graphics  and  color  disabled.
  1508.             Sometimes this  is not desirable, especially on systems that
  1509.             use a  monochrome video  display adapter  (blue text appears
  1510.             underlined on  a monochrome display, and since the door uses
  1511.             a LOT  of blue...).   To  disable color  output to the local
  1512.             console, use  the -mono command line parameter.  This switch
  1513.             has no effect on the remote user.
  1514.  
  1515.             USAGE  :  BWMAIL -MONO
  1516.             DEFAULT:  Color output on local display.
  1517.  
  1518.  
  1519.        Carrier Detect Override (-NOCD)
  1520.        -------------------------------
  1521.             Normally, the  door requires that a carrier detect signal be
  1522.             present in  order for the door to send data through the comm
  1523.             port.   This poses  a problem  when trying  to run  the door
  1524.             through a NULL modem cable, or something similar.
  1525.  
  1526.             If  the  command  line  parameter  -NOCD  is  used,  carrier
  1527.             detection will  be disabled,  and data  will be sent through
  1528.             the comm  port regardless of whether a carrier is present or
  1529.             not.   This switch  should NOT  be used  with a  remote user
  1530.             online, since  the caller  may drop  carrier and tie up your
  1531.             system until  there  is  an  input  timeout  (default  of  4
  1532.             minutes).
  1533.  
  1534.             USAGE  :  BWMAIL -NOCD
  1535.             DEFAULT:  Carrier detect active (unless in local mode).
  1536.  
  1537.  
  1538.        Override Stamping Downloaded Messages "Rec'd" (-NORECV)
  1539.        -------------------------------------------------------
  1540.             When door  gathers  messages  for  a  user,  it  stamps  all
  1541.             messages addressed  to that  user as  "Received", to give an
  1542.             indication to  the sender  that the  message may  have  been
  1543.             read.   The -NORECV  parameter causes  the door  to skip the
  1544.             process of  marking such  messages as "Received", leaving no
  1545.             indication that they have been read.
  1546.  
  1547.             This parameter  probably should  not be  used for normal BBS
  1548.             usage, however,  it may come in handy if the SysOp wishes to
  1549.             download his/her mail, but not leave any indication that the
  1550.             messages have  been read  (the SysOp  may not  have time  to
  1551.             reply to  the messages  downloaded at  that particular time,
  1552.             for example).
  1553.  
  1554.             USAGE  :  BWMAIL -NORECV
  1555.             DEFAULT:  Personal messages marked "Received" when bundled.
  1556.  
  1557.  
  1558.        Work Directory Override (-WORK=)
  1559.        --------------------------------
  1560.  
  1561.                  --------------------------------------------------
  1562.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 27
  1563.  
  1564.             If you  would like  to override  the default  WORK directory
  1565.             defined within BWMAIL.PRM, use the -WORK parameter.
  1566.  
  1567.             USAGE  :  BWMAIL -WORK=<path to WORK directory>
  1568.             DEFAULT:  Drive and path defined within BWMAIL.PRM.
  1569.  
  1570.  
  1571.        Download Directory Override (-DOWN=)
  1572.        ------------------------------------
  1573.             If you would like to override the default DOWNLOAD directory
  1574.             defined within BWMAIL.PRM, use the -DOWN parameter.
  1575.  
  1576.             USAGE  :  BWMAIL -DOWN=<path to DOWNLOAD directory>
  1577.             DEFAULT:  Directory defined within BWMAIL.PRM.
  1578.  
  1579.  
  1580.        Upload Directory Override (-UPLOAD=)
  1581.        ------------------------------------
  1582.             If you  would like  to override the default UPLOAD directory
  1583.             defined within BWMAIL.PRM, use the -UPLOAD parameter.
  1584.  
  1585.             USAGE  :  BWMAIL -UPLOAD=<path to UPLOAD directory>
  1586.             DEFAULT:  Drive and path defined within BWMAIL.PRM.
  1587.  
  1588.  
  1589.        Log File Override (-LOG=)
  1590.        -------------------------
  1591.             Each copy  of the  door that  is running requires a separate
  1592.             log file.   Log  files cannot  be shared between two or more
  1593.             different tasks.  This parameter is used to override the log
  1594.             file name that is defined within BWMAIL.PRM.  In most cases,
  1595.             it would  be  more  convenient  to  use  the  "%T"  or  "%N"
  1596.             replacement macro  in declaring  the name  of the  log  file
  1597.             within  the   BWSETUP  Directories  and  File  Name  Editor.
  1598.             However, this  alternate way of overriding the log file name
  1599.             is provided for special situations.
  1600.  
  1601.             This parameter  can also  be convenient when you do not want
  1602.             to keep  a log  file for  a certain  task (usually  a  local
  1603.             node).   If "-LOG="  is specified  WITHOUT a filename, a log
  1604.             file will not be generated for that session.
  1605.  
  1606.             USAGE  :  BWMAIL -LOG=<name of log file>
  1607.             DEFAULT:  Filename defined within BWMAIL.PRM.
  1608.  
  1609.  
  1610.        Auto-Download Mode (-D)
  1611.        -----------------------
  1612.             Specifying -D  on the  command line  will cause  the door to
  1613.             immediately go  into Auto-Download  mode.   In Auto-Download
  1614.             mode, the door immediately begins scanning the message areas
  1615.             and bundles  a mail  packet.  If there is a remote user, the
  1616.             door will  immediately  fire  up  the  appropriate  download
  1617.             protocol, and  then exit  back to  the BBS.   If there is no
  1618.             remote user,  the door  skips executing  the  protocol,  and
  1619.  
  1620.                  --------------------------------------------------
  1621.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 28
  1622.  
  1623.             drops back  to the  calling batch  file.   This is extremely
  1624.             handy for  local use in batch files to possibly build a mail
  1625.             bundle during  a maintenance  "event".   The door  will  NOT
  1626.             prompt for user input during the entire session.
  1627.  
  1628.             USAGE  :  BWMAIL -D
  1629.             DEFAULT:  "Interactive Menu" mode.
  1630.  
  1631.  
  1632.        Auto-Upload Mode (-U)
  1633.        ---------------------
  1634.             Specifying -U  on the  command line  will cause  the door to
  1635.             immediately go  into Auto-Upload mode.  This parameter works
  1636.             the same as the -D parameter, in that the user will never be
  1637.             prompted for input during the mail session.
  1638.  
  1639.             USAGE  :  BWMAIL -U
  1640.             DEFAULT:  "Interactive Menu" mode.
  1641.  
  1642.  
  1643.        Auto Logoff Mode (-INSTANT or -COUNT)
  1644.        -------------------------------------
  1645.             These parameters only have an effect on the operation of the
  1646.             door when the following conditions are met:
  1647.  
  1648.             1)  The door must be in Auto-Upload or Auto-Download mode.
  1649.             2)  There must be a remote user online.
  1650.  
  1651.             The -INSTANT  parameter will  cause the  door to  perform an
  1652.             IMMEDIATE  LOGOFF   of  the  user  (drop  carrier)  after  a
  1653.             successful Auto-Upload or Auto-Download session.
  1654.  
  1655.             The -COUNT  parameter will  cause  the  door  to  perform  a
  1656.             COUNTDOWN LOGOFF of the user (drop carrier after a 10 second
  1657.             countdown) after  a successful  Auto-Upload or Auto-Download
  1658.             session.
  1659.  
  1660.             USAGE  :  BWMAIL <-D or -U> -INSTANT
  1661.             USAGE  :  BWMAIL <-D or -U> -COUNT
  1662.             DEFAULT:  Return to BBS with remote user still online.
  1663.  
  1664.  
  1665.        Section 5.4  Multi-Node Installation Considerations
  1666.  
  1667.        The Blue  Wave Mail Door is fully capable of multi-node operation, and
  1668.        provides facilities  for ease of operation and configuration on multi-
  1669.        node systems.  There are a few points that you need to be aware of.
  1670.  
  1671.        All nodes on your system can use the same mail door base directory, as
  1672.        full file sharing and file locking is supported.  You can even use the
  1673.        same door  configuration file (BWMAIL.PRM) on all nodes on your system
  1674.        if you  like.   It is  also possible to use DIFFERENT BWMAIL.PRM files
  1675.        for each  node on your system by passing the /C<filename> command line
  1676.        parameter to  BWMAIL.EXE.   Many (if  not all)  of the  necessary door
  1677.        parameters that  can vary  between nodes  can be  passed on the door's
  1678.  
  1679.                  --------------------------------------------------
  1680.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 29
  1681.  
  1682.        command  line,  thereby  overriding  any  information  in  the  door's
  1683.        configuration file.   It  is recommended  that you  read Section  5.3,
  1684.        "BWMAIL Command  Line  Parameters",  for  full  information  on  these
  1685.        command line overrides.
  1686.  
  1687.        It is  also important to note that all nodes must have their own WORK,
  1688.        DOWNLOAD, and  UPLOAD directories.   Failure  to do  so will result in
  1689.        file name clashes between nodes if two users are using the door at the
  1690.        same time.  The solution for this problem is to either use the /DOWN=,
  1691.        /UPLOAD=, and  /WORK= command line parameters, or the "%T" and/or "%N"
  1692.        replacement macros  in the  BWSETUP Directories and File Paths editor.
  1693.        When the  door begins  execution, it  will replace  all occurrences of
  1694.        "%T" and  "%N" with  the task  number passed  to the  door through the
  1695.        /T<task#> command  line parameter,  or  the  node  number  found  from
  1696.        PCBOARD.SYS.   (Press <F1>  while in  the BWSETUP Directories and File
  1697.        Paths editor  for more  information on  these task  number replacement
  1698.        macros.)
  1699.  
  1700.        To recap, the following problems must be avoided when running The Blue
  1701.        Wave Mail Door on a multi-node system:
  1702.  
  1703.             1)   Each task must have its own WORK directory.
  1704.             2)   Each task must have its own DOWNLOAD directory.
  1705.             3)   Each task must have its own UPLOAD directory.
  1706.             4)   Each task must have its own LOG file name.
  1707.  
  1708.        If the  above four  conditions are not met, your door will not perform
  1709.        as expected,  and you  may receive  SHARE violations  when two or more
  1710.        users are in the mail door at the same time.
  1711.  
  1712.        NOTE:   It is  HIGHLY recommended  that you  set the  standard PCBoard
  1713.        environment variables  (PCBDRIVE, PCBDIR,  and PCBDAT) to point to the
  1714.        proper drives,  directories, and  file names.   The standard mail door
  1715.        installation  uses   these  environment   variables  to   create   the
  1716.        BLUEWAVE.BAT batch file.
  1717.  
  1718.  
  1719.        Section 5.5  Supported PCBoard Features
  1720.  
  1721.        The Blue  Wave Mail  Door makes  every attempt  to be  compatible with
  1722.        PCBoard,  with  all  PCBoard  conference  configuration  and  security
  1723.        settings.   Below are  important items  to consider  when  determining
  1724.        whether or  not a  particular PCBoard feature is also supported in The
  1725.        Blue Wave  Mail Door.  If reference to a particular feature of PCBoard
  1726.        is unfamiliar  to  you,  please  see  the  PCBoard  documentation  for
  1727.        implementation details.
  1728.  
  1729.             *    The Blue  Wave Mail Door will honor all security levels
  1730.                  in both  conferences and file areas.  This includes new
  1731.                  files  scanning,   file  requesting,   and   conference
  1732.                  read/posting access.
  1733.  
  1734.             *    When a  user uploads  FidoNet NetMail  messages through
  1735.                  the mail  door, Blue  Wave will  use the  nodelist path
  1736.                  defined in  PCBoard.  If a destination system cannot be
  1737.  
  1738.                  --------------------------------------------------
  1739.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 30
  1740.  
  1741.                  found in  the PCBoard  nodelist, the  message  will  be
  1742.                  treated as  if it were to an "Unlisted Node".  The cost
  1743.                  accounting will  be done according to the Unlisted Node
  1744.                  security  and   cost  settings  in  BWSETUP's  Security
  1745.                  Manager.
  1746.  
  1747.             *    When performing  file  request  sessions,  all  upload/
  1748.                  download  ratio   and  daily   byte  limit  checks  are
  1749.                  performed.  When the mail door exits, it will write the
  1750.                  new user  file statistics  to USERS.SYS.   When PCBoard
  1751.                  reloads, it  will detect  the changes made to this file
  1752.                  and update its internal statistics accordingly.
  1753.  
  1754.             *    The mail  door  fully  supports  the  extended  message
  1755.                  fields (FROM,  TO, FROM2, TO2, SUBJ, etc.) that PCBoard
  1756.                  uses to  overcome its  limit of 25 characters per field
  1757.                  in message  headers.   When a  user downloads messages,
  1758.                  these fields  are used to build a proper message header
  1759.                  in the  mail packet;  during upload, the mail door will
  1760.                  insert these  fields into  messages as  needed.   Thus,
  1761.                  extended  From:,  To:,  and  Subject:  fields  will  be
  1762.                  preserved  across   the   board,   without   any   user
  1763.                  intervention at all.
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.                  --------------------------------------------------
  1798.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 31
  1799.  
  1800.  
  1801.  
  1802.                                      ----------------------------------------
  1803.                                      Chapter 6:  INSTALLING EXTERNAL PROGRAMS
  1804.                                      ----------------------------------------
  1805.  
  1806.  
  1807.        Section 6.1  Installing External Support Programs
  1808.  
  1809.        Configuring external  programs for use with The Blue Wave Offline Mail
  1810.        Door is  perhaps the  single most important aspect of getting the mail
  1811.        system to  work properly.   Close to 100% of the problems that you may
  1812.        encounter while  using the mail door are due to incorrectly configured
  1813.        or missing program command lines.  This section of the documentation -
  1814.        - along  with the  following sub-sections  -- attempt  to explain,  in
  1815.        great detail,  the proper  way to  configure external programs for use
  1816.        with the mail system.
  1817.  
  1818.        It  is  important  to  remember  that  you  must  have  at  least  one
  1819.        compression  program   and  the  corresponding  decompression  program
  1820.        command line  defined in  order to operate the mail door successfully.
  1821.        ZIP-formatted mail  packets are so common that it is almost imperative
  1822.        that you  have a  ZIP compression  and ZIP decompression program. Most
  1823.        users will have some type of ZIP compression program already installed
  1824.        on their  system. (Please see Chapter 4 for more information regarding
  1825.        required external  programs).   For this  reason, you should read this
  1826.        chapter very carefully if you are having trouble getting the mail door
  1827.        to create a mail packet for download.
  1828.  
  1829.  
  1830.        Section 6.2  The PATH Environment Variable
  1831.  
  1832.        Throughout this  documentation, and  in many other program manuals you
  1833.        may read, you will see references to what is called "the system PATH",
  1834.        "the PATH environment variable", and "DOS (or OS/2) PATH".
  1835.  
  1836.        In order  to understand the configuration of external programs in this
  1837.        or any  other program,  it is  essential that you understand what this
  1838.        terminology is referring to.
  1839.  
  1840.        Each time you boot your computer, MS-DOS reads two configuration files
  1841.        from the  root directory  of your boot drive (usually C:\).  These two
  1842.        files are  called CONFIG.SYS  and AUTOEXEC.BAT.   The PATH environment
  1843.        variable is  configured in  the file AUTOEXEC.BAT under MS-DOS.  (Note
  1844.        that OS/2 uses the CONFIG.SYS file for setting the system PATH.)
  1845.  
  1846.        If you  load the  file AUTOEXEC.BAT  into a text file editor, you will
  1847.        probably see a line that reads:
  1848.  
  1849.             PATH c:\;c:\dos;c:\windows
  1850.  
  1851.        The names of the directories listed in this line may be different from
  1852.        above.   Each directory  name is  separated by a semi-colon (;).  If a
  1853.        program is  "located on  the system  PATH", it  simply means  that the
  1854.        file(s) needed  to run  this program  are in  one of  the  directories
  1855.  
  1856.                  --------------------------------------------------
  1857.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 32
  1858.  
  1859.        listed on  this line.   You  can add  new  directories  to  your  PATH
  1860.        statement by  simply editing  this line  to include  the new directory
  1861.        (make sure  that if  there are  any directories listed before or after
  1862.        the new  directory entry,  that you separate them with a semi-colon!).
  1863.        Under DOS,  the maximum  length of  this line  is 127  characters, and
  1864.        under OS/2 the maximum length of this line is 1024 characters.
  1865.  
  1866.        Please note that any changes you make to your CONFIG.SYS file and your
  1867.        AUTOEXEC.BAT file  will not  become effective  until you  REBOOT  your
  1868.        system.  They are only read by DOS and OS/2 once;  at system startup.
  1869.  
  1870.        When DOS,  OS/2, or  any program  running under  these  two  operating
  1871.        systems tries  to  run  a  program,  it  first  searches  the  current
  1872.        directory to see if the program is there.  If it is there, the program
  1873.        is run  from the  current directory.  If it is NOT there, DOS and OS/2
  1874.        begin searching  the directories listed in this line.  The directories
  1875.        are searched in the order they appear.  If, after searching the entire
  1876.        list of  directories contained  in this  line, the  program cannot  be
  1877.        found, DOS will issue this error message:
  1878.  
  1879.             Bad command or file name.
  1880.  
  1881.        The behavior  and use  of the  PATH environment  variable is described
  1882.        here because  DOS and  OS/2 will behave in the same manner as the mail
  1883.        door when it cannot find a program you have told it to run -- although
  1884.        the mail  door's error  messages are a bit more friendly.  Any program
  1885.        that you  try to  run through  the mail  door must  be located  on the
  1886.        system PATH.
  1887.  
  1888.        The purpose  of  the  system  PATH  environment  variable  is  one  of
  1889.        convenience.   If a  program is  located in a directory located on the
  1890.        system path,  that program can be run from ANY directory you happen to
  1891.        be in.   For  example, when  you  install  Windows,  it  installs  the
  1892.        C:\WINDOWS directory  on the  system path.  No matter where you are on
  1893.        your computer,  typing "WIN"  will start  the Windows Program Manager.
  1894.        If you  were to  remove "C:\WINDOWS"  from the  system path and reboot
  1895.        your  machine,   you  would  be  required  to  be  in  the  C:\WINDOWS
  1896.        subdirectory before Windows could load.
  1897.  
  1898.        While the  mail door  is running,  it changes  directories at  several
  1899.        different points  in time.   It is therefore not possible to place the
  1900.        external programs  in the door's base directory and expect them to run
  1901.        properly (unless  the mail  door directory  is in  your system  PATH).
  1902.        Most people  find it  convenient to  have one  or two directories that
  1903.        hold important system utility files (such as PKZIP and PKUNZIP).
  1904.  
  1905.  
  1906.        Section 6.3  Configuring External Archiver Programs
  1907.  
  1908.        In order  to pack and unpack messages that are downloaded and uploaded
  1909.        from your  system, it  is necessary  for the mail door to spawn (call,
  1910.        execute, run) external compression and decompression utilities.
  1911.  
  1912.        Configuring an  archiver  with  BWSETUP  is  fairly  straight-forward.
  1913.        Simply load  BWSETUP, highlight  the "Archiver Definitions" menu item,
  1914.  
  1915.                  --------------------------------------------------
  1916.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 33
  1917.  
  1918.        and press  [Enter].   You will  be presented  a list  of up  to  eight
  1919.        archivers --  highlight the  archiver you  would like to work with and
  1920.        press [Enter] again.
  1921.  
  1922.        To add  a new archiver definition, highlight one of the lines that are
  1923.        filled with  dots and  press [Enter].   You  will be  presented with a
  1924.        'blank' entry  screen in  which to define your archiver.  If you would
  1925.        like to  remove an  archiver from  the list, highlight the archiver to
  1926.        work with  in the selection list, press [Enter], then set the archiver
  1927.        hotkey to a [Space] character.
  1928.  
  1929.        Once you  have begun  editing an  archiver definition,  you will  find
  1930.        several fields  available to  you.   For questions  about any  of  the
  1931.        fields, press  <F1> while  that field  is highlighted.  The two fields
  1932.        that  deserve   deeper  explanation   here  are  the  Compression  and
  1933.        Decompression command lines.
  1934.  
  1935.        The compression  command line  is used  when the mail door is ready to
  1936.        send a mail packet to the user.  Several files are created in the mail
  1937.        door's temporary  working directory  that need to be compressed into a
  1938.        single file  for transmission to the user.  Here you need to enter the
  1939.        command line that should be executed in order to accomplish this task.
  1940.        Two macros  should be  used when defining archiver compression command
  1941.        lines.  Please see Sections 6.3.1 and 6.3.2 for more information.
  1942.  
  1943.        The decompression  command line  is used when the mail door receives a
  1944.        reply packet from the user (the user has uploaded messages to the mail
  1945.        door).   The mail  door calls the decompression command line to unpack
  1946.        the reply  messages to its temporary working directory for processing.
  1947.        Here you  need to  enter the  command line  that should be executed in
  1948.        order to  accomplish this  task.   Two  macros  should  be  used  when
  1949.        defining archiver  decompression command  lines.   Please see Sections
  1950.        6.3.1 and 6.3.2 for more information.
  1951.  
  1952.  
  1953.        Section 6.3.1  Macros Used for Archiver Definitions
  1954.  
  1955.  
  1956.        Two macros  should be used when defining your archiver compression and
  1957.        decompression command  lines in  order to  work properly with the mail
  1958.        door configuration  (especially with  multi-node  systems).    In  the
  1959.        descriptions below,  we will  assume  that  your  mail  door  Download
  1960.        Directory is  configured as  "C:\BBS\DOWN", that your mail door Upload
  1961.        Directory is  configured as  "C:\BBS\UP", that  your  mail  door  Work
  1962.        Directory is  configured as  "C:\BBS\WORK", and that your mail door is
  1963.        configured to use a Mail Packet ID of "MYBBS".
  1964.  
  1965.        @F   Use the  @F macro  in a compression command line to represent the
  1966.             name of the file that will be created by the compression program.
  1967.             For example,  to create  a .ZIP  file with  PKZIP, PKZIP needs to
  1968.             know the  name of the .ZIP file to create.  If your mail door was
  1969.             configured as described above, "PKZIP @F" would expand to:
  1970.  
  1971.                  PKZIP C:\BBS\DOWN\MYBBS.SU1
  1972.  
  1973.  
  1974.                  --------------------------------------------------
  1975.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 34
  1976.  
  1977.             Use the @F macro in a decompression command line to represent the
  1978.             name of the file that needs to be decompressed by the archiver.
  1979.             For example, to unpack a file with PKUNZIP, PKUNZIP needs to know
  1980.             the name of the file to decompress.  If your mail door was
  1981.             configured as described above, "PKUNZIP @F" would expand to:
  1982.  
  1983.                  PKUNZIP C:\BBS\UP\MYBBS.NEW
  1984.  
  1985.        @I   Use the  @I macro  in a compression command line to represent the
  1986.             path and  file name(s)  that will  be packed into the destination
  1987.             archive.     For   example,   to   create   an   archive   called
  1988.             C:\BBS\DOWN\MYBBS.SU1  with   all  of  the  files  found  in  the
  1989.             C:\BBS\WORK directory, you would issue the following command line
  1990.             for PKZIP:
  1991.  
  1992.                  PKZIP C:\BBS\DOWN\MYBBS.SU1 C:\BBS\WORK\*.*
  1993.  
  1994.             This same command line would be represented in the door as "PKZIP
  1995.             @F @I".
  1996.  
  1997.             Use the @I macro in a decompression command line to represent the
  1998.             destination path  of the  files that  will be  unpacked from  the
  1999.             archive.   For example,  to unpack  MYBBS.NEW to  the door's Work
  2000.             Directory (C:\BBS\WORK), you would issue the following command to
  2001.             PKUNZIP:
  2002.  
  2003.                  PKUNZIP MYBBS.NEW C:\BBS\WORK\
  2004.  
  2005.             This same  command line  would be  represented  in  the  door  as
  2006.             "PKUNZIP @F @I".
  2007.  
  2008.  
  2009.        Section 6.3.2  Sample Archiver Command Lines
  2010.  
  2011.        Sample archiver  commands are listed below which illustrate the use of
  2012.        the @F  and @I archiver macros.  All of these examples assume that the
  2013.        executable file  for the  archiver is located somewhere on your system
  2014.        PATH (see  Section 6.2).   All of these command lines have been tested
  2015.        with the mail door and have proven themselves to work.
  2016.  
  2017.        Sample DOS Archiver Command Lines
  2018.        ---------------------------------
  2019.  
  2020.        ZIP Compression  :  PKZIP -ex @F @I
  2021.        ZIP Decompression:  PKUNZIP -o @F @I
  2022.  
  2023.        ARJ Compression  :  ARJ a -e @F @I
  2024.        ARJ Decompression:  ARJ e -y @F @I
  2025.  
  2026.        LZH Compression  :  LHA a /m @F @I
  2027.        LZH Decompression:  LHA e /m @F @I
  2028.  
  2029.  
  2030.        Sample OS/2 Archiver Command Lines
  2031.        ----------------------------------
  2032.  
  2033.                  --------------------------------------------------
  2034.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 35
  2035.  
  2036.  
  2037.        ZIP Compression  :  ZIP -jk9 @F @I
  2038.        ZIP Decompression:  UNZIP -oj @F -d @I
  2039.  
  2040.        ARJ Compression  :  <no ARJ was available for OS/2>
  2041.        ARJ Decompression:  <you need ARJ compress to use ARJ decompress!>
  2042.  
  2043.        LZH Compression  :  LH a /o @F @I
  2044.        LZH Decompression:  LH e /o @F @I
  2045.  
  2046.  
  2047.        Section 6.3.3  Notes About Archiver Command Lines
  2048.  
  2049.        Please  note   that  you  must  have  at  least  one  compression  and
  2050.        decompression program  configured in  the mail door.  Some SysOps will
  2051.        find that  they never  have to install anything but ZIP.  However, the
  2052.        mail door  gives you  the ability  to define  up to  eight  individual
  2053.        compression types for users to choose from.
  2054.  
  2055.        PKZIP and  its companion program PKUNZIP are, by far, the most popular
  2056.        ZIP compression  and decompression utilities available for MS-DOS.  If
  2057.        you are  installing a  DOS version  of Blue  Wave, you  should install
  2058.        PKZIP.EXE and PKUNZIP.EXE in a directory on your system which contains
  2059.        other important  system utilities.  At the time this documentation was
  2060.        written, version  2.04g  was  the  latest  available  version  of  the
  2061.        PKZIP/PKUNZIP utilities.
  2062.  
  2063.        If you are using an OS/2 version of the mail door, you should find and
  2064.        obtain a copy of the InfoZip Project's ZIP.EXE and UNZIP.EXE for OS/2.
  2065.        It is  recommended that you use ZIP v2.01 or later, and UNZIP v5.12 or
  2066.        later, due  to bugs  and compatibility problems with earlier versions.
  2067.        These version  numbers of  ZIP/UNZIP are  known to work properly under
  2068.        OS/2 with  the Blue Wave Mail Door.  If you cannot find these programs
  2069.        locally, you are welcome to download them from our Support BBS.
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.                  --------------------------------------------------
  2093.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 36
  2094.  
  2095.  
  2096.  
  2097.                                           -----------------------------------
  2098.                                           Chapter 7:  OPERATING THE MAIL DOOR
  2099.                                           -----------------------------------
  2100.  
  2101.  
  2102.        Section 7.1  General Mail Door Operation
  2103.  
  2104.        Now that  we have  examined the operation of BWSETUP in detail and you
  2105.        have  gone   through  the   initial  installation  process,  it  seems
  2106.        appropriate to discuss the operation of the mail door itself.
  2107.  
  2108.        The main  bridge between your BBS software and The Blue Wave Mail Door
  2109.        is called  the "door  drop file."   This  file is  created by  all BBS
  2110.        software, but  the format and the name of the file varies depending on
  2111.        the software  you are  using.   QuickBBS, RemoteAccess,  SuperBBS, and
  2112.        ProBoard all  use a  file called EXITINFO.BBS.  Maximus and Opus use a
  2113.        file called  LASTUSxx.BBS or  LASTUSxx.DAT, where  'xx'  is  the  node
  2114.        number the user is currently using.  PCBoard uses two drop files named
  2115.        PCBOARD.SYS and  USERS.SYS.   T.A.G. and  Telegard use  a file  called
  2116.        DOOR.SYS.
  2117.  
  2118.        Each time  the mail door is loaded, information about the current user
  2119.        is loaded  from this door drop file.  This includes the user name, the
  2120.        speed at  which they  are logged  on, and other vital information.  In
  2121.        fact, if the mail door cannot load this file during initialization, it
  2122.        will refuse  to run.  (The exception to this is when the /K<user_name>
  2123.        command line parameter is used.  Please see the Sections titled "Using
  2124.        the Mail  Door in  Local Mode"  and "Command Line Parameters" for more
  2125.        information.)
  2126.  
  2127.        If all  of the  mail door's  initialization files could be loaded, all
  2128.        three of  the door's  private working  directories are  purged of  any
  2129.        files they  might be  holding.   These three directories, the Download
  2130.        Directory, Upload  Directory, and Work Directory, should never contain
  2131.        files that  you plan  on keeping.   These  are intended solely for the
  2132.        mail door's use, and the mail door expects them to be 'clean' in order
  2133.        to operate properly.
  2134.  
  2135.        After the  door has initialized itself and prepared for operation, the
  2136.        user will  be shown  either the  file BWINTRO.TXT  (if they  have ANSI
  2137.        graphics turned  off) or  BWINTRO.ANS.  If the user has never used the
  2138.        mail door  before, or if their mail door user record has been deleted,
  2139.        they will  be shown  the text in the file NEWUSER.HLP, followed by the
  2140.        default mail door configuration settings.
  2141.  
  2142.  
  2143.        Section 7.2  Functions Available While a User is Online
  2144.  
  2145.        The mail  door contains  several functions that the SysOp can activate
  2146.        while a  user is  online.   The mail  door is  always in "simultaneous
  2147.        keyboard mode",  meaning that  whatever you type on the local keyboard
  2148.        will also  be echoed  to the  remote user and processed just as if the
  2149.        key had  come from  the remote  user.   However, there are special key
  2150.  
  2151.                  --------------------------------------------------
  2152.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 37
  2153.  
  2154.        combinations that  do not  echo to the remote user, and that cannot be
  2155.        activated by  the remote  user.   In order  to perform  any  of  these
  2156.        functions, they *must* be activated from the SysOp's console.
  2157.  
  2158.        Before we  discuss the  "SysOp Keys",  let's explain some things about
  2159.        the status  bar on  the bottom  row of your screen.  The status bar is
  2160.        not visible to your remote users, of course.  During normal operation,
  2161.        you will  only see  one visible  line, however  there are actually two
  2162.        lines that  make up the status bar display.  When you press your SysOp
  2163.        keys, additional  information will  fill the second status line.  This
  2164.        additional information  will be  cleared, and  the status bar updated,
  2165.        every 15 seconds.
  2166.  
  2167.        Here are the keys available while a user is online:
  2168.  
  2169.             The <Home> Key
  2170.             --------------
  2171.             Pressing the  <Home> key  while a user is online will display all
  2172.             of the  function keys  available to you.  Think of the <Home> key
  2173.             as a mini online help guide.
  2174.  
  2175.             The <Alt-C> Key
  2176.             ---------------
  2177.             While a  user is  online, you can press the <Alt-C> key to "chat"
  2178.             with the  user.   Entering  chat  mode  allows  you  to  interact
  2179.             directly with the user at the remote end.  Each key that you type
  2180.             will be  echoed to  the remote user, and each key the remote user
  2181.             types will be sent to your screen.
  2182.  
  2183.             To exit chat mode at any time, simply press the <Esc> key.  After
  2184.             you exit  chat mode  with a  user, both the remote user's display
  2185.             and the local display will be repainted with the information that
  2186.             was on the screen at the time chat mode was entered.
  2187.  
  2188.             The <Alt-D> Key
  2189.             ---------------
  2190.             Pressing <Alt-D> while a user is online will perform an immediate
  2191.             shell to  the operating  system (DOS  or OS/2, depending on which
  2192.             mail door  type you  are running).   Don't worry, the remote user
  2193.             will not be able to see what you are doing!  A message is sent to
  2194.             the user  before the  shell is performed, and once again when you
  2195.             return from the shell.  Please remember that you must type "EXIT"
  2196.             at the DOS or OS/2 command line prompt in order to return control
  2197.             to the mail door.
  2198.  
  2199.             The <Alt-H> Key
  2200.             ---------------
  2201.             Made for  those users  who are just plain annoying or are abusing
  2202.             your system, the <Alt-H> keypress will perform a disconnect (drop
  2203.             carrier) and then exit the mail door.  Control is returned to the
  2204.             BBS system.   The BBS software should see that there is no longer
  2205.             a user online and should recycle the BBS system.
  2206.  
  2207.             The <Alt-N> Key
  2208.             ---------------
  2209.  
  2210.                  --------------------------------------------------
  2211.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 38
  2212.  
  2213.             The <Alt-N> keypress will cause the mail door to display extended
  2214.             information about  the current  user, including  their alias name
  2215.             and/or their  "real" name.   This information, as with all of the
  2216.             special function  key information,  will be  cleared in  about 15
  2217.             seconds for a more "tidy" appearance.
  2218.  
  2219.             The <PgDn> and <DownArrow> Keys
  2220.             -------------------------------
  2221.             Pressing <PgDn> while a user is online will decrease the time the
  2222.             user has  remaining in  the mail  door by ten minutes.  To reduce
  2223.             the time remaining by thirty minutes, simply press the <PgDn> key
  2224.             three times.  Pressing the <DownArrow> cursor key also lowers the
  2225.             current  user's  time  remaining,  but  does  so  in  one  minute
  2226.             increments.
  2227.  
  2228.             The <PgUp> and <UpArrow> Keys
  2229.             -----------------------------
  2230.             Pressing <PgUp> while a user is online will increase the time the
  2231.             user has  remaining in the mail door by ten minutes.  To increase
  2232.             the time remaining by thirty minutes, simply press the <PgUp> key
  2233.             three times.   Pressing  the <UpArrow>  cursor key also increases
  2234.             the current  user's time  remaining, but  does so  in one  minute
  2235.             increments.
  2236.  
  2237.  
  2238.        Section 7.3  Maintaining The Blue Wave Mail Door
  2239.  
  2240.        One of  the most  popular features  of The  Blue Wave Mail Door is the
  2241.        small amount  of maintenance  that is required.  Because the mail door
  2242.        operates directly  with your BBS software, no message area maintenance
  2243.        is required.  Each time the mail door loads, it reads all message area
  2244.        definitions   and   security   settings   directly   from   your   BBS
  2245.        configuration.  This means that once you have configured a new message
  2246.        area in  your BBS  configuration utility,  you do not have to add that
  2247.        same message area to the mail door configuration!
  2248.  
  2249.        The same  holds true  for removing  message area  definitions.  If you
  2250.        decide to  remove a message area from your BBS configuration, the mail
  2251.        door will  recognize that  the area  is no  longer available  and will
  2252.        automatically disable it from a user's mail scan.
  2253.  
  2254.        Section 7.3.1  Message Area Overrides
  2255.  
  2256.        The BWSETUP  program allows  you to  define "Message  Area Overrides".
  2257.        Message area  overrides allow  you to  override any  settings for  any
  2258.        message area  available on  your BBS.   Since  the mail door reads all
  2259.        information directly from your BBS system's configuration each time it
  2260.        loads, any  changes made  to the message area configuration in the BBS
  2261.        automatically get carried over to the mail door.
  2262.  
  2263.        It may  be desireable,  at times,  to override  the BBS's message area
  2264.        configuration information.   By  defining a message area override, you
  2265.        can change  many of the settings and security levels needed for access
  2266.        to any  particular message  area while a user is in the mail door.  If
  2267.        you move  message areas around (for example, you move area #33 to area
  2268.  
  2269.                  --------------------------------------------------
  2270.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 39
  2271.  
  2272.        #47), and you have a message area override configured for that message
  2273.        area, it may be necessary to modify the area override also.  If you do
  2274.        not define  message area  overrides,  there  will  be  no  maintenance
  2275.        necessary when moving, adding, or deleting message areas from your BBS
  2276.        configuration.
  2277.  
  2278.        Another feature  of the  message area  override editor  is the  use of
  2279.        "Forced" and  "Default" message areas.  To force a message area ON for
  2280.        all users of the mail door, you simply define a message area override.
  2281.        At the  bottom of  the Message Area Override Editor screen, there will
  2282.        be an option to set this area as "Forced".  Turning this on will cause
  2283.        this message  area to  be forced  on for  all users  who  have  enough
  2284.        security to  access the  message area.  If a user does NOT have enough
  2285.        security for access to the message area, the area will not be enabled.
  2286.  
  2287.        The same  procedure may be used to define "Default" message areas.  If
  2288.        a message  area is  configured as  a default  area, any  new user  who
  2289.        accesses the  mail door,  and who  has enough  security  to  read  the
  2290.        message area,  will find that the message area is automatically turned
  2291.        on for  them.  The difference between default message areas and forced
  2292.        message areas  is that a user CAN disable a default area, but a forced
  2293.        area cannot  be disabled  by the user.  Forced message areas remain on
  2294.        even if  a user performs an offline configuration to disable the area,
  2295.        or if  the user  tries to  modify the  messages downloaded in the area
  2296.        through the use of the Blue Wave Bundling Commands.
  2297.  
  2298.        Obviously, you  should use  discretion when  defining  forced  message
  2299.        areas.   They are best used for system announcement message areas, and
  2300.        for "private"  or EMail  message areas, where a user can only download
  2301.        messages that are directly addressed to them.
  2302.  
  2303.  
  2304.        Section 7.3.2  Removing Old User Records
  2305.  
  2306.        The only routine maintenance that should be performed on the mail door
  2307.        is the  deletion (removal)  of old  mail  door  user  records.    This
  2308.        maintenance could,  and should  be added  to your  nightly  or  weekly
  2309.        system maintenance schedule.
  2310.  
  2311.        The BWSETUP  program will remove all old user records for you.  Simply
  2312.        run "BWSETUP PURGE 30" to remove all users that have not used the mail
  2313.        door in  30 days.  Run "BWSETUP PURGE 90" to remove all users who have
  2314.        not used  the mail  door in  90 days.   The  "PURGE nn"  command  line
  2315.        parameter for  BWSETUP will  cause BWSETUP  to *not* enter interactive
  2316.        mode.  This allows you to run the purge utility in an unattended batch
  2317.        file.
  2318.  
  2319.  
  2320.        Section 7.4  Creating and Using Reader Bulletin Files
  2321.  
  2322.        The Blue Wave Mail Door has the ability to include "Welcome" or reader
  2323.        bulletin files.  When a user downloads a mail packet and loads it into
  2324.        The Blue Wave Offline Mail Reader (and other Blue Wave-compatible mail
  2325.        readers), these  bulletin  files  are  available  for  viewing  either
  2326.        automatically or  upon user  demand.  These reader files may either be
  2327.  
  2328.                  --------------------------------------------------
  2329.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 40
  2330.  
  2331.        plain ASCII  or ANSI files.  They can be used to send an advertisement
  2332.        of new  items or echos available on the BBS, or new services that your
  2333.        system offers.
  2334.  
  2335.        In the  BWSETUP program,  under the  "General Information" editor, you
  2336.        will find  five "slots",  where you can define the bulletin files that
  2337.        will be  included in  a mail  packet download.  In each of these slots
  2338.        you may  define the  file name  to be  sent, and  the minimum security
  2339.        needed in order to be able to view the file.  (If a user does not have
  2340.        sufficient security  to view one or more bulletin files, they will not
  2341.        be included  in the  mail packet.)  The file names that you place here
  2342.        must reside in the mail door's base directory.
  2343.  
  2344.        The Blue  Wave Offline  Mail Reader will behave differently, depending
  2345.        into which "slot" you have placed a reader bulletin file.  If a reader
  2346.        bulletin is  placed into  slot #1,  this bulletin will be displayed to
  2347.        the user  automatically after  opening a  mail packet.   This behavior
  2348.        cannot be  modified by the user -- think of it as a "Forced" bulletin.
  2349.        If you  place a  file name  in slot  #2 or  slot #3, the bulletin will
  2350.        automatically be  displayed if the user has enabled automatic bulletin
  2351.        display in  the mail  reader.   If the user has disabled the automatic
  2352.        bulletin display,  these files will only be viewable upon user demand.
  2353.        Slot #4 and slot #5 are always available upon user demand only.
  2354.  
  2355.        You may  use two  special macros in the reader bulletin files in order
  2356.        control their display to the user:
  2357.  
  2358.        {PAUSE} -  Place this  macro on  a line  by itself  to force  a screen
  2359.             pause.   The user  will receive  a "Press  any key  to  continue"
  2360.             message, and their screen will be cleared after pressing a key to
  2361.             continue.
  2362.  
  2363.        {BEEP} -  Sounds a beep in the mail reader, if the user has not turned
  2364.             sound off in the mail reader.
  2365.  
  2366.  
  2367.        Section 7.5  Using the Mail Door in Local Mode
  2368.  
  2369.        The Blue  Wave  Mail  Door  has  several  provisions  for  making  the
  2370.        packaging of  local mail  downloads easy  and hassle-free.  Many times
  2371.        SysOps will  opt to use The Blue Wave Offline Mail System to read mail
  2372.        locally on  their machines  at home,  or even  to pack  messages in  a
  2373.        nightly event to take to work with them.
  2374.  
  2375.        Using this method will also allow SysOps running DESQview, Windows, or
  2376.        OS/2 to read mail packets with The Blue Wave Offline Mail Reader while
  2377.        still leaving the BBS online.
  2378.  
  2379.        For this  example, we  will assume that you already have The Blue Wave
  2380.        Offline Mail Reader installed in a directory called C:\BWAVE, and that
  2381.        your DOWNLOAD directory in the mail reader configuration is defined as
  2382.        C:\BWAVE\DOWN, your  UPLOAD directory  is defined  as C:\BWAVE\UPLOAD,
  2383.        and your  WORK directory  is defined  as C:\BWAVE\WORK.   This example
  2384.        also assumes  that the  physical  computer  on  which  the  reader  is
  2385.        installed is  the same  computer that  contains your BBS and mail door
  2386.  
  2387.                  --------------------------------------------------
  2388.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 41
  2389.  
  2390.        installation.   (They may  also be  installed on  a different physical
  2391.        computer, but with the same drives accessible through a LAN.)
  2392.  
  2393.        To get  the best  results from  the interaction of the reader and mail
  2394.        door, it  is highly suggested that you set "Keep Old DL Packets (Don't
  2395.        Erase)" to "YES" in the BWSETUP->Options and Toggles Editor.
  2396.  
  2397.        The next BWSETUP configuration items you will need to edit are located
  2398.        on the  "Directories and File Paths" configuration menu.  While in the
  2399.        directories  editor,  move  the  cursor  through  the  fields  to  the
  2400.        "Temporary Work  Directory" under the "Local Mail Door Usage" section.
  2401.        You can  enter any  path here  you like, as the reader and the door do
  2402.        not  need  to  share  (and  should  not  share!)  the  temporary  work
  2403.        directories.
  2404.  
  2405.        You should then define your "Reader Download (In) Directory" to be the
  2406.        same as  the "Download  Directory" defined  in the mail reader (in our
  2407.        example, this  would be  C:\BWAVE\DOWN).   Define your  "Reader Upload
  2408.        (Out) Directory"  to be  the same as the "Upload Directory" defined in
  2409.        the mail reader (in our example, this would be C:\BWAVE\UPLOAD).
  2410.  
  2411.        Press <Esc>  to leave the Directories and File Paths editor, choose to
  2412.        exit BWSETUP,  and save your current configuration.  You are now ready
  2413.        to create two batch files.  The first batch file will execute the mail
  2414.        door in  auto-download mode (to build your mail bundle), and the other
  2415.        will execute  the door  in auto-upload mode (to send your replies back
  2416.        through the mail door).
  2417.  
  2418.        Two sample  batch files  are shown  below.  BWDOWN.BAT can be executed
  2419.        each time  you wish  to build  a mail  packet.    BWUP.BAT  should  be
  2420.        executed each time you have replied to messages in the mail reader and
  2421.        are ready  to send  them back  to the  mail door  to be processed.  In
  2422.        these sample batch files, enter the commands shown on the left side of
  2423.        the page.   Comments  on the  right side  of the  page are  there  for
  2424.        explanatory purposes only and should not be entered in the batch file.
  2425.  
  2426.  
  2427.        Sample BWDOWN.BAT
  2428.        -----------------
  2429.        c:                       Change to the drive where BWMAIL.EXE is
  2430.        cd \bbs\bluewave         Change to the directory where BWMAIL.EXE is
  2431.        bwmail /kjoe;sysop;PWRD:bbspassword /d
  2432.  
  2433.  
  2434.        Sample BWUP.BAT
  2435.        ---------------
  2436.        c:                       Change to the drive where BWMAIL.EXE is
  2437.        cd \bbs\bluewave         Change to the directory where BWMAIL.EXE is
  2438.        bwmail /kjoe;sysop;PWRD:bbspassword /u
  2439.  
  2440.  
  2441.        You should, of course substitute "joe;sysop;PWRD:bbspassword" with the
  2442.        name and  password that  you use  to log into the BBS.  In both cases,
  2443.        the mail  door will  perform the desired function and exit back to the
  2444.  
  2445.  
  2446.                  --------------------------------------------------
  2447.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 42
  2448.  
  2449.        batch file.   The  mail door will not ask for input in local mode when
  2450.        performing an auto-upload or auto-download.
  2451.  
  2452.  
  2453.        Section 7.6  The FidoNet->Internet Gateway
  2454.  
  2455.        The Blue  Wave Mail  Door supports  the option  of a  transparent user
  2456.        interface to  a  FidoNet->Internet  Gateway.    The  FidoNet->Internet
  2457.        Gateway menu  option in  BWSETUP allows you to configure the mail door
  2458.        to provide  a method for users to gain easy access to Internet E-mail,
  2459.        without actually requiring the BBS to be connected to the Internet.
  2460.  
  2461.        In order for this feature to work, you must be a member of FidoNet, or
  2462.        a FidoNet-style  network.   This is  due to the fact that the Internet
  2463.        gateway actually  uses a  FidoNet-style NetMail area to store messages
  2464.        that are entered through a mail reader in the Internet Gateway area.
  2465.  
  2466.        When the Internet gateway is configured and active, an Internet E-mail
  2467.        area is  created in the user's mail packet.  The user can then use the
  2468.        mail reader to create Internet E-mail messages.  When the user uploads
  2469.        the reply  packet, the  mail door  will take  these reply messages and
  2470.        convert them  to FidoNet  NetMail messages  addressed to the FidoNet<-
  2471.        >Internet gateway system you defined.
  2472.  
  2473.        Even if  your BBS  offers 'true'  Internet capabilities,  the Internet
  2474.        gateway can  be offered  alongside them,  if you  wish.   It will  not
  2475.        interfere  with   them,  as  the  Internet  gatway  uses  the  FidoNet
  2476.        capabilities of your BBS to do its work.
  2477.  
  2478.        **   Internet E-mail capabilities are available only with version 2.20
  2479.             and later  of The  Blue Wave Offline Mail Reader, and with third-
  2480.             party mail readers compatible with Version 3 or later of the Blue
  2481.             Wave mail packet specifications.
  2482.  
  2483.        For further information about each configuration item available in the
  2484.        BWSETUP FidoNet<->Internet  Gateway Editor, please press <F1> for help
  2485.        when the field you would like more help with is highlighted.
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.                  --------------------------------------------------
  2506.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 43
  2507.  
  2508.  
  2509.  
  2510.                                      ----------------------------------------
  2511.                                      Chapter 8:  SOFTWARE SUPPORT INFORMATION
  2512.                                      ----------------------------------------
  2513.  
  2514.        The Blue Wave Offline Mail System is a growing and developing software
  2515.        package.   Cutting Edge Computing is always interested in hearing your
  2516.        comments and  suggestions for  ways we  can Blue  Wave work better for
  2517.        you.  We take into consideration every request that we get in order to
  2518.        make The Blue Wave Mail System a first-class offline mail package.
  2519.  
  2520.        If you are having trouble with The Blue Wave Offline Mail Reader, Blue
  2521.        Wave Offline  Mail Door, or have comments and suggestions, please drop
  2522.        us a  line.   We can be reached through our support BBS by dialing +1-
  2523.        810-743-8464.   Our support  BBS is  online 24 hours per day, 7 days a
  2524.        week.
  2525.  
  2526.        You can  reach other  users of  The Blue  Wave Offline  Mail System to
  2527.        discuss problems  with the  software, discuss  time-saving techniques,
  2528.        and other  issues related  to your  use of the mail system through the
  2529.        BLUEWAVE echo on the FidoNet backbone.
  2530.  
  2531.        Limited technical  support is  provided by surface mail, however it is
  2532.        very difficult  to diagnose problems through a letter.  Please use the
  2533.        support BBS if at all possible.  Unregistered users of the mail reader
  2534.        need to include a self-addressed, stamped envelope if you would like a
  2535.        reply.   For inquiries  outside of the United States, you must enclose
  2536.        an International Reply Coupon (available at your local post office).
  2537.  
  2538.        Sorry, but  voice technical  support is reserved for registered owners
  2539.        of The  Blue Wave  Offline  Mail  System.    When  calling  for  voice
  2540.        technical support,  please be  sure to  have your registration numbers
  2541.        available.   Technical support  must verify  your registration  number
  2542.        before assisting  you.   The technical  support phone  number will  be
  2543.        provided to you on your registration confirmation letter.
  2544.  
  2545.        Cutting Edge  Computing is  owned and  operated by  George Hatchew  in
  2546.        Burton, Michigan, USA.  Here are our various addresses:
  2547.  
  2548.        US POSTAL SERVICE
  2549.             Cutting Edge Computing
  2550.             P.O. Box 90476
  2551.             Burton, Michigan  48509-0476  USA
  2552.  
  2553.        SUPPORT BBS
  2554.             1:2240/176          (FidoNet)
  2555.             +1-810-743-8464     (Direct Phone Number)
  2556.  
  2557.        INTERNET
  2558.             bluewave@concentric.net                 (Internet Email)
  2559.             http://www.concentric.net/~bluewave     (World Wide Web Site)
  2560.  
  2561.        Thank you  for trying The Blue Wave Offline Mail System.  We hope that
  2562.        the mail system provides you enjoyment and value for years to come!
  2563.  
  2564.                  --------------------------------------------------
  2565.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 44
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.                  --------------------------------------------------
  2624.               The Blue Wave Offline Mail Door/PCBoard, v4.00;  Page 45